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instruction sets 
supported 


Interactive cross- 
referencing 


Creates listing orq 
after disassembly i 
perfect 


Dis*Doc Professional™ 


New Dis*Doc Professional is your dual-mode disas¬ 
sembler to any DOS source code. It works in batch 
and interactive modes simultaneously, allowing you 
to generate the core information of even the most 
complex programs fast.. .and modify them even 
faster. Most programs will come apart in just two 
minutes. Imagine what you can do with a tool this 
powerful! Dis'Doc sifts through programs eight 
times for guaranteed accuracy. When code gets 
mixed up with data, our toolbox comes to the rescue 
with smart search and easy edit utilities. 

Warning: Dis*Doc Professional may change the way 
you work forever. 

Programmers who used to shy away from fixing 
outmoded programs with no source code are going 
to discover a valuable new talent: the ability to 
modify and revise codes that would cost way too 
much to start over (it's a programming manager's 
dream). Save your employer huge new-program¬ 
ming fees and enhance your marketability. Dis'Doc 
is so easy to learn, you'll be a high-dollar hero in no 
time! 

Dis'Doc Professional is an amazing new teaching 
tool. Learn how programs work...take them apart 
and see the writing techniques that top pros use. Use 
it to assist in debugging. Hunt down viruses and 
write killers. Dis’Doc can save you years of frustra¬ 
tion, and it only costs $249.95. 


"A simple must in any serious programmer's toolbox. 
We used it to compress BIOS' for BlueMAX. ''-Bob 
Smith, President, Qualitas, Inc. 


COMPARE FOR YOURSELF! 



DiS'Doc™ 

Sourcer™ 

Speed of disassembly (bytes/sec) 

822 

120 

Accuracy (code/data separation*) 

99.9% 

99.9% 

Unlimited file size 

YES 

NO 

BIOS labeling 

YES 

XTRA $$ 

BIOS/PSP file labeling 

YES 

NO 

Unpacks EXE files 

YES 

XTRA $$ 

Patcher 

YES 

NO 

Batch mode 

YES 

YES 

Interactive mode 

YES 

NO 

Time it takes to customize a label 

5 sec. 

2-5 min. 

Time it takes to change data to code 

5 sec. 

2-5 min. 

*at eight passes based on a 9040 byte EXE file picked at random . 

Sourcer is a registered trademark of V Communications, Inc. 


To order your DisdDoc Professional™ disassembler 
toolkit or our $10 demo disk, simply call: 

1 - 800 - 336-1961 in US andCanada 

1-203-489-5335 voice 1-203-489-5746 fax 

or send check or money order for $249.95 plus $6 s&h to: 

RJSwantek, Inc. 

178 Brookside Road 
Newington, CT 06111-1320 USA 

MasterCard & Visa Shipped Immediately Via UPS Blue inside US. 












































C CODE FOR THE PC 

source code, of course 

NEW! Image Compression Library (patented ”VARI” technology, transmit full screen in 15 seconds, includes JPEG, license required) .$950 

NE W! Virtual Memory Objects (btrees, lists, arrays, and other multiple memory classes in heap, EMM, and swap file; no royalties).$750 

Embedded DOS (full-features, real-time, multitasking, 3.31-compatible DOS for embedded system and self-bootable installations).$375 

Spell Time (spelling checker for incorporation into text products; no royalty; large dictionary; small and fast).$300 

ZIP Image Processor & Victor Image Library Version 2.0 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 

TbrboTyrX (Release 3.0; HP, PS, dot drivers; CM fonts; LaTjgX; MetaFont).$250 

Rogue Wbve tools.h+-(- or math.h++ Class Library (extensive docs).each $240 

NEW! Merjin++(C++class library for modeling & simulation; queues, statistical tools, fourier transforms, differential equations; no royalties) . . $220 

NEW! PxSQL(SQLfor Borland’s Paradox Engine; ANSI X3.135-1989 SQL-DML standard; network server not required).$180 

NEW! Embedded DOS Utility SDK (C source for standard DOS utilities— FDISK, FORMAT and COMMAND.COM).$170 

c_pslib (PostScript generation library for C programs; includes complete graphics, font, rotation & paragraph support.$170 

WKS Library Version 2.01 (C program interface to Lotus 1-2-3, dBase, Supercalc 4, Quatro, & Clipper) .$155 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25” or 3.5” diskettes).each $150 

Delorie GCC for MS-DOS (Version 1.39; includes C++, assembler & DOS extender; complete source code and makefiles).$150 

Updated! Heap Expander (Version 3.0, virtual memory manager using expanded memory, extended memory and disk; XMS, VCPI, LIM).$135 

CBTree (B+tree ISAM driver, multiple variable-length keys) .$135 

TE Editor Developer’s Kit (full screen editor, undo command, multiple windows; with word processing: $195; Windows 3.0: $200).$130 

C++ Object Library (virtual windows, I/O, lists, file free space management, keyed ISAM file I/O).$125 

Booter Tbolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) .$120 

WinMem (unlimited global memory handles for Windows 3.0,4-byte overheadper block rather than 20, virtual memory for 286).$110 

NEW! CSIM (discrete event simulator library; clocks, chains, future events, multiple servers, queues, reports).$100 

Updated! PC/IP (CMU/MIT TCP/IP for PCs; Clarkson drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . $100 

Heapman (application memory management for Windows 3.0; 64K bytes of heap space; includes memory browser/debugger) .$100 

EZTrieve (Novell Btrieve access with data dictionary and data manager, no royalties).$100 

CDB for DOS & Unix (database toolkit; ISAM, DDL, relational & network, space reuse, concurrent access; fast, no royalty).$95 

Kier FinanceLib (interest, conversions, annuities, depreciation, cash flow, bonds, etc.).$95 

PowerSTOR (Version 1.2; extended heap space on extended memory, expanded memory, and/or hard disk).$95 

NE W! Script Interpreter (a command script interpreter for DOS-based systems; C-like script language; lots of features).$90 

NE W! Visions 1.20 (text window user interface management system; includes mouse support and background processing).$80 

VMEM (virtual memory manager by Blake McBride, Version 3.6, LRU pager, dynamic swap file, image save/restore).$80 

chase (C database library, sequential & b+-tree random access, buffered block I/O, file-level locking).$75 

NE W! TreeDraw (PostScript display of labeled hierarchical trees; DOS & Windows screen display included; Moen algorithm).$75 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C++).each $65 

Foundations-1 C++ Class Library (ASCII record I/O, bit arrays, exception handling, B-tree, persistent objects).$60 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

NEW! MEM.WING (global memory manager for Windows, supports standard C memory allocation calls to ’’wing” your old Ccode into Windows) . $55 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

FinanC (large collection of financial function including bond, inventory, stock portfolio, & cash flow).$55 

CALC (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Mini IDL (interface generator for complex data; single inheritance, translator & table generator tools, ASCII external form only)).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

Floppy TAR (TAR backup and restore on MS-DOS devices; direct access to non-standard devices) .$50 

C Compiler Pack (5 C compilers; 3 for 8086 (gcc, MicroC, Small C), 2 for 68000 (Sozobon, cc68); gcc ports include library source only) ... $50 

SuperGiep (exceptionally fast, revolutionaiy text searching algoritnm; also searches sub directories).$50 

OBJASM (convert ,obj files to .asm files; output is MASM compatible) .$50 

CLIPS Version 5.0 (rule-based expert system generator; advanced manuals available at additional cost).$50 

NIH Class Library & Book (basic C+ + classes & Data Abstraction and Object-Oriented Programming In C+ + in softback by Keith Gorien) . $50 

Editor Pack (15 public domain editors; including microEmacs 3.11, Stevie, Elvis, Moke, mg2a, DTE, Jove, & Origami).$50 

NEW! NETS Version 2.01 (neural net simulator from COSMIC).$40 

NE W! Cint (C interpreter).$40 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; domestic distribution only) .... $40 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Updated! Database Pack (9 databases -simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

Bison & BYACC (YACC workalike parser generators; documentation; no restrictions on use of BYACC output).$35 

NEW! Object-Oriented Programming in C++ (code from the book by Naba Barkakati).$30 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

Updated! REGX Plus (Version 2.0, search and replace string manipulation routines based on regular expressions).$30 

GNU Awk & Dill for PC (both programs in one package).$30 

Make Pack (eight versions of Make including dmake 3.7, GNU Make, Cake, and Gymake and a makefile maker).$30 

Updated! Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Updated! Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

String Pack (lots of string routines; C++String class, BAWK, word wrap, fuzzy search, Boyer-Moore, Hypertext, etc.).$25 

Updated! UUPC Pack (UUCP for the PC; UUPC Version 1.11k by Wonderworks and smail/PC Version 2.5 by Stephen C. Tbier).$25 

PERL for MS-DOS (C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

Tel (Idol Command Language; add shell programming programming capability to any command line; elegant command line language) . . . $25 

FLEX (fast lexical analyzer generator; new, improved LEX; BSD Version 2.3.6 with docs).$25 

NEW! Livermore Loops in C (the famous Fortran benchmark transliterated to Q includes technical report as PostScript file) .$20 

XLISP 2.1 (includes Almy improvements).$20 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development).$20 

NE W! Gperf Version 2.5 (GNU’s perfect hash table generator; requires DJ gcc; includes executable; specify C or C+ +) .each $20 

SDBM (fast, disk-based hash table manager for really large hash tables; clone of Unix ndbmj .$20 

Data 

Moby Thesaurus (25K root words, 1.2M synonyms; requires signed license agreement).$350 

Moby Part-of-Speech (200,000 words and phrases described by prioritized part(s)-of-speech).$120 

Moby Words (500,000 words & phrases, 9,000 stars, 15,000 names).$80 

Moby Shakespeare (plays, sonnets, etc. ... every last word).$60 

Dictionary Word List (234,932 words in alphabetical order).$60 

Roget’s 1911 Thesaurus.$40 

Updated! Database Pack (9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

The World Digitized (100,000 longitude/latitude of world country boundaries) .$30 

NEW! Lots ’O Words (160,086 German, 178,430 Dutch, 61,843 Norwegian, 60,453 Italian, 138,257 French, 53,142 English) .$30 

NE W! CIA World Bank II Database (also known as the ’’small” CIA world map; coastlines, rivers, lakes, political boundaries).$25 

NE W! Dan Klein’s Dictionaries (53,091 words and phrases in 25 dictionaries).$20 

NEW! Text Pack (1990 CIA World Fact Book and the Hacker’s Jargon file).$20 

The Austin Code Works Voice: (512) 258-0785 

11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-13)2 

Austin, Texas 78750-3587 USA E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 
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WE HAVE AN OBJECTIVE 
POINT OF VIEW 

...with the Turbo Vision Development Toolkit forTurbo Pascal 6.0 


We view traditional programming that requires recompilation to see changes to the program 
interface in a completely new and different way! Turbo Vision Development Toolkit lets you 
interactively create or change dialog boxes, menus and string lists in the Turbo Vision application 
framework. You can use the Resource Editor to develop and see Turbo Vision interface objects 
exactly as they will appear in yourfinal application. The Resource Editor saves 
the objects to a resource file that can be loaded into your application with a 
single method call. 

The Toolkit also includes a utility to translate your resource files into Windows 
3.0 resource script files. This makes it easier to port your Turbo Vision 
applications to Windows. 

An ongoing objective... 

We couldn’t and didn’t stop with just powerful utilities. We’ve built a number of 
objects that make your development easier and your applications more bullet¬ 
proof. Just some of these objects are an Enhanced Help Facility to display 
context-specific help information; a Memory Monitor to record and display 
memory usage; an Event Monitor to display all or selected events processed by 
Turbo Vision. 



These objects are especially useful during program development and debugging, and we’ve made 
it easy for the objects to be added to or removed from your application with a single statement. 

And, there's more... 


Of course, the Turbo Vision Development Toolkit comes with a comprehensive Reference 
Manual and Tutorial. The source code for all objects and utilities is included. 




819 Bancroft Way Berkeley, California 94710 (510)540-5441 


BLAISE COMPUTING INC. 


Consider our point of view... 


The Turbo Vision Development Toolkit requires Turbo Pascal 6.0 and costs just 
$149. We’re so convinced that you’ll find these utilities and objects essential that if 
during the first 60 days you’re not completely satisfied, we’ll refund your money. 
That’s a 60-day money back guarantee! 


Call our order department toll free (800) 333-8087, today! 


Trademarks are property of their respective holders. 
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From 

The Editor 


The foreign market is making up a larger percentage of revenues for all 
of the major PC application software vendors. Windows 3.0 alone is current¬ 
ly available in 194 countries, in Dutch, Finnish, French, German, Italian, Kanji, 
Korean, Norwegian, Portuguese, Spanish, Swedish and Chinese (Arabic, Czech, 
Hebrew, Hungarian, and Turkish are on the way). 

Have you ever worked on a software product that eventually sold in 
another country? Let me guess how it happened. The product was originally 
designed with no thought toward portability, let alone internationalization. 
Over the years, you maintained it and extended it in response to users’ 
requests. Then one day, your CEO looked in a trade magazine and read 
what percentage of Microsoft’s profits come from the overseas market. The 
next day, the CEO read an article in the Wall Street Journal titled “Is Your 
Product Ready for the European Community?” Finally, on the third day, your 
manager called a little meeting with the programmers and said “What will 
it take to internationalize this product?” 

If you have not already been through the above scenario, this issue of 
Windows/DOS Developer's Journal can save you some work. We have articles 
written by people who have a lot of experience with internationalizing 
software. The sooner you understand the issues involved and adapt your 
designs accordingly, the less work you will have waiting for you when 
someone in management realizes that non-English-speaking countries are 
buying a lot of software. 

If you have already had to retrofit software to separate the text in the 
user interface from the program, this issue can show you how to make 
your life easier next time. If your experience was only with European or 
only with Japanese localization, you may still be unaware of problems 
presented by the other class of languages; we discuss both here. 

An old joke says that a person who speaks three languages is called 
trilingual and a person who speaks two languages is called bilingual, but a 
person who speaks only one language is called an American. When you 
consider the fact that software is in the dwindling class of American exports 
that enjoys a positive trade balance with other countries, now is the time 
for us to write programs that are multilingual, and not just American. 

Ron Burk 

Editor 



Ron Burk’s CompuServe address was listed incorrectly in recent issues. 
The correct address is.- 70302,2566 
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■ Windows Questions And Answers 


5 



Paul Bonneau 


You may address Win¬ 
dows questions to Paul in 
care of Windows/DOS 
Developer's Journal a t 
1601 W. 23rd SC, ste. 200, 
P.O. Box 3127, Lawrence, 
KS 66044-0127, or you 
may contact him via in¬ 
ternet as 

bonneauOhyper. hyper.com. 


Q Can anyone tell me if it is possible to use a colored brush for the background 
of a dialog box? I’ve tried to get access to the dialog box class structure to 
change hbrBackground without success. Thanks in advance. 

Chris B. Turner, 
cbt@cam-orl.co.uk 

A You can color the dialog just as you would a normal window, by trapping the 
UM_ERASEBKGND message. This message supplies a DC to be erased. When the 
message is received, the DC will contain an update region specifying the area to be 
erased. Even though GDI will clip any attempt to paint the DC outside of this region, 
you can realize a small increase in speed by painting only the invalidated area. 

case WM_ERASEBKGND: 

{ 

RECT rect; 

HBRS hbrsSav; 

GetClipBox(wParam, &rect); 

/* hbrs is your brush. */ 
hbrsSav = 

SelectObject(wParam, hbrs); 

PatBlt(wParam, rect.left, 
rect.top, 

rect.right - rect.left, 
rect.bottom - rect.top, 

PATCOPY); 

SelectObject(wParam, hbrsSav); 

} 

return TRUE; 

The above code will color the dialog’s background, but will not affect the color of 
the controls. If you want to use the same color for the backgrounds of the control 
and the dialog, you will also need to trap the UM_CTLCOLOR message. This message is 
sent from a control to the dialog just before the control erases or paints itself. It 
allows the dialog to set the background and foreground colors, and to return a brush 
to use for erasing. 


Paul Bonneau is the senior software design engineer for Hypercube, Inc., #7-419 
Phillips St, Waterloo, Ontario, Canada, N2L 3X2. His current project is HyperChem, a 
molecular modelling software package for Windows. Paul has been developing Win¬ 
dows applications for 5 years. Much of his expertise was gained at Microsoft, where 
he implemented a library module used by all of Microsoft's major Windows applica¬ 
tions. You can reach Paul via internet as bonneau@hyper.hyper.com. 






















There is also a trick you can use to speed up background 
erasing a little more. It turns out that ExtTextOut() is the 
fastest way to get solid colors on the screen! This is mainly 
because you save a call (or two) to SelectObject(), which 
can be a significant amount of time. But on some displays, 
such as a 256 color Super VGA, the actual painting itself can 
be twice as fast 

The following code can be used to erase a dialog and its 
controls using the ExtTextOut() trick. Color is specified using 
the COLORERF “clr" (I have used a mustard-like color in this 
example): 

Idefine clr 0x00007f7f 


use Load Icon () because the icon is not stored in the .exe 
file. 

What I have is: (1) a handle to a monochrome bitmap rep¬ 
resenting the transparent part of the icon-, (2) a handle to the 
color bitmap of the icon. Is there a correspondence between 
these two handles and the icon handle supplied to the Draw- 
Icon () procedure? 

Any help is appreciated. 

Best regards 

Niels Erik Holm 
RC International 
Denmark 
neh@rci.dk 


case WM_ERASEBKGND: 

{ 

RECT rect; 

SetBkColor(wParam, clr); 

GetClipBox(wParam, &rect); 

ExtTextOut(wParam, 0, 0, 

ET0_0PAQUE, &rect, NULL, 0, 

NULL); 

} 

return TRUE; 

case WM_CTLC0L0R: 

SetBkColor(wParam, clr); 
return 

GetStockObject(HOLLOW BRUSH); 

Q l have some problems with displaying icons. I cannot 
use DrawIcon(), because 1 want to read the icon bit¬ 
maps from a file (not from the . exe file itself). The Windows 
SDK documentation says that Drawlconf) only accepts icons 
loaded via a call to the Load Icon () procedure. And I can not 


Listing 1 (icon.h) 


^*****************************************************y 

/* Types. */ 

typedef struct 


POINT 

ptHot; 

/* 

Hotspot. */ 

int 

dx, dy; 

/* 

Width and height. */ 

WORD 

cbLine; 

/* 

Width of monochrome bitmap in */ 



/* 

bytes. */ 

BYTE 

cpln; 

/* 

Number of planes in color */ 



/* 

bitmap. */ 

BYTE 

cbit; 

/* 

Bits per plane in color */ 



/* 

bitmap. */ 

BYTE 
} ICN; 

rgb[l]; 

/* 

Bitmaps (mono then color). */ 


typedef ICN FAR 


LPICN; 


j**★★★*******★★***************************************j 

/* Prototypes. */ 

y*****************************************************y 
HICON HicnFromBmpBmp(HBITMAP, HBITMAP); 

/* End of File */ 

Interface to Icon Creation Module 


A Listing 1 shows the internal structure of an ICON. Unfor¬ 
tunately, this is not publicly documented by Microsoft, 


Listing 2 (icon.c) 

y *****************************************************j 
/* Header files. */ 

y *****************************************************j 
#include <windows.h> 
linclude "icon.h" 


y*****************************************************y 
/* Routines. */ 
y*****************************************************y 


HICON 


HicnFromBmpBmp(HBITMAP hbmpColor, HBITMAP hbmpMono) 


/* -- Given a color and monochrome bitmap with the */ 
/* dimension, create and return a handle to an */ 
/* icon. */ 
/* — hbmpColor : Color bitmap. */ 
/* — hbmpMono : Monochrome bitmap. */ 


y****************************************************** y 
( 


LPICN lpicn; 

BITMAP bmpColor, bmpMono; 
HICON hicn; 

DWORD cbColor, cbMono; 


/* Get the header info from the bitmaps. */ 
GetObject(hbmpMono, sizeof bmpMono, (LPSTR)&bmpMono); 
cbMono = bmpMono.bmWidthBytes * bmpMono.bmHeight; 
GetObject(hbmpColor, sizeof bmpColor, (LPSTRj&bmpColor); 
cbColor * bmpColor.bmWidthBytes * bmpColor.bmHeight; 


/* Get some space for the icon. */ 
hicn = GlobalAlloc(GMEM_MOVEABLE, sizeof *lpicn - 
sizeof(BYTE) + cbColor + cbMono); 
if (hicn NULL) 
return hicn; 


/* Initialize the icon header info. */ 
lpicn - (LPICN)GlobalLock(hicn); 
lpicn->cbLine - bmpMono.bmWidthBytes; 
lpicn->dx - bmpColor.bmWidth; 
lpicn->dy * bmpColor.bmHeight; 
lpicn->ptHot.x - lpicn->ptHot.y * 0; 
lpicn->cpln = bmpColor.bmPlanes; 
lpicn->cbit = bmpColor.bmBitsPixel; 

/* Finish the filling the icon with bitmap bits. */ 
GetBitmapBits(hbmpMono, cbMono, lpicn->rgb); 
GetBitmapBits(hbmpColor, cbColor, 
lpicn->rgb + cbMonoj; 

GlobalUnlock(hicn); 
return hicn; 

} 


/* End of File */ 


Module Implements a Routine to Create an Icon 
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which means the implementation could change without warn¬ 
ing. It is the same for both versions 3.0 and 3.1, however, so 
it’s safe to use at least until the next major release of Win¬ 
dows. 

The same structure is used for both icons and cursors. The 
ptHot field defines the “hotspot” for a cursor. This is the offset 
that is added to the location of the origin that is reported via 
mouse messages. The rgb field is where the bitmaps are kept 
The monochrome bitmap comes first, followed by the color. 
You can verify this structure given a loaded icon (LoadlconO) 
by using LockResourcef) on the icon handle to get a far 
pointer to the struct. Use UnlockResourcef) to release the 
memory. 

Listing 2 shows a routine that will construct an icon handle 
from a pair of bitmaps. The handle returned can then be sup¬ 
plied to DrawIcon(). When you are finished with the icon, it 
can be discarded with GlobalFreef). 

Q We want to use function keys as accelerators, in modal 
dialog boxes. As a modal dialog box has its own loop 
which processes messages, the accelerator keys are not trans¬ 
lated. Help! 

Deenar Toraskar 
Citicorp Software 
aimsuserOncst.ernet.in 

A Right you are. TranslateAccelerators () is used to 
generate UM_COMMAND messages from an accelerator 
table and a keystroke message. Unfortunately, the dialog 
manager’s message loop message does not call Translate- 
Accelerators (). But Windows does provide a message hook 
that gets called each time the dialog manager or menu 
manager extracts a message from the application's queue. 

The hook function can examine, modify, and even discard 
any such message. So if you trap keystrokes in the hook func¬ 
tion and call TranslateAccelerators(), the function can dis¬ 
card the message if translation occurs. This is the same 
functionality as if TranslateAccelerators() were included in 
the dialog or menu manager’s message loop. 

Listings 3 and 4 implement a routine to create a modal 
dialog with a developer supplied accelerator table. Listing 3 is 
the header file to include in any code making use of the 
routine AcceleratedDialogO. Listing 4 is the implementation 
of the routine. 

This routine takes 5 parameters: 

LPSTR IszDialog■. Name of dialog resource, 

LPSTR IszAccel: Name of accelerator table, 

FARPROC Ipfn■. Actual address of DialogProc, 

HANDLE hins: App’s instance handle, and 
HUND hwndOwner. Dialog owner window. 

AcceleratedDialogO takes care of the bookkeeping for 
creating an instance handle of the dialog; the caller does not 
need to MakeProcInstance() the dialog procedure. If numeric 
values are used in the resource file to identify the dialog and 
accelerator table, MAKEINTRESOURCE can be used for the 
parameters IszDialog and IszAccel. 


Listing 3 (dlgaccel.h) 

VOID AcceleratedDialog(LPSTR, LPSTR, FARPROC, 

HANDLE, HWND); 

/* End of File */ 

Interface to Dialog with Accelerator Table Module 


The hook function, AcceleratorHook(), uses GetWindow- 
Long() to test whether the window is a child window. Calling 
TranslateAccelerators() for a child window is usually a big 
mistake, since Windows will assume the control id stored in 
the menu handle slot really is a menu handle. The routine 
uses the parent window handle if the message is for a child. 

Since AcceleratorHook() is a callback, make sure to name 
it in the EXPORTS section of your linker module definition file. 

AcceleratedDialogO has been designed to be re-entrant, 
just in case your dialog procedure is capable of invoking 
another modal dialog. If AcceleratedDialogO is re-entered, it 
will reuse the hook function already in place. 

Q We have developed a windows application using 
Microsoft Windows SDK and Microsoft C compiler v.6.0. 
We have two versions of our application, both of which use 
the medium memory model. Version (a) uses local memory 
allocation and runs fine until it runs out of memory. Version 
(b) uses global memory allocation and it runs very slowly 
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compared with (a). For a typical example, running standard 
mode on a 286 machine with plenty of memory, version (b) 
takes 8 to 15 times as long as version (a) to solve the same 
problem. Questions: 

1. Why is the version with global memory allocation so much 
slower than the version with local memory allocation? 

2. What if anything, can we do to speed up the global 
memory version? 

3. Would switching to the large memory model help, or 
would it make things worse? 

4. Is there any way to used based addressing with Windows? 


5. Is there any way to put edit controls in global memory so 
that we can free up more local memory? 

6. Do you have any suggestions for solving our memory prob¬ 
lem without slowing down the program by a large factor? 

Charles H. Roth 
chroth@emx.utexas.edu 

answer your questions in order: 

1. One of the key speed factors is long versus near pointers. 
With global memory, your application must use far 
pointers to access the memory, but with local memory (in 


Listing 4 (dlgaccel.c) 

/*****************************************************i 

hmemAccel - LoadAccelerators(hins, lszAccel); 

/* -- Make sure you EXPORT AcceleratorHook() in your */ 

DialogBox(hins, lszDialog, hwndOwner, 

/* .def file! */ 

Ipfnlnstance); 

/*****************************************************i 

FreeResource(hmemAccel); 

j*****************************************************j 

hmemAccel = hmemAccelSav; 

FreeProcInstance(lpfnlnstance); 

/* Header files. */ 


1********************* ********************************j 

if (hmemAccel ** NULL) 

{ 

findude <windows.h> 

linclude "dlgaccel.h" 

UnhookWindowsHook(WH MSGFILTER, lpfnAccel); 

!*****************************************************j 

lpfnAccelSav = NULL; 

FreeProcInstance(lpfnAccel); 

/* Private static variables. */ 

i 

/*****************************************************/ 

} 

static FARPROC lpfnAccelSav; /* Previous hook. */ 


static HANDLE hmemAccel; /* Accel. table. */ 

int FAR PASCAL 

J ***************************************************** j 

AcceleratorHook(int msgf, WORD wParam, DWORD IParam) 

/* Private prototypes. */ 

/* -- Message filter windows hook. */ 

j*****************************************************j 

/* -- Look for keystrokes and invoke */ 

int FAR PASCAL AcceleratorHook(int, WORD. DWORD): 

/* TranslateAcceleratorO. */ 

j*****************************************************j 

j*****************************************************j 
( 

/* Routines. */ 

DWORD lVal; 

f*****************************************************j 


VOID 

if (msgf »■ 0 && hmemAccel != NULL) 

{ 

Accel eratedDialog(LPSTR lszDialog, LPSTR lszAccel, 

switch (((LPM$G)lParam)->message) 

FARPROC lpfnDialog, HANDLE hins, HWND hwndOwner) 

1 

J*****************************************************j 

default: 

/* -- Create a dialog with an accelerator table. */ 

break; 

/* -- lszDialog : Name of dialog resource. */ 


/* -- lszAccel : Name of accelerator table. */ 

case WM KEYDOWN: 

/* — lpfn : Actual address of DialogProc. */ 

case WM KEYUP: 

/* — hins : App's instance handle. */ 

case WM SYSKEYDOWN: 

/* -- hwndOwner : Dialog owner window. */ 

case WM SYSKEYUP: 

/*****************************************************j 

( 

i 

HWND hwnd = ((LPMSG)lParam)->hwnd; 

FARPROC Ipfnlnstance; /* DialogProc instance. */ 


FARPROC lpfnAccel; /* Hook instance. */ 

/* Make sure we don't do this for a child */ 

HANDLE hmemAccelSav; /* Last accel. table. */ 

/* window, since Windows will think the */ 

/* If this is the first instance of this routine */ 

/* id is a menu handle! */ 
if (GetWindowLong(hwnd, GWL STYLE) & 

/* (since it can be called recursively), create */ 

WS CHILD) 

/* and install the message hook. */ 

hwnd = 

if (hmemAccel == NULL) 

/ 

GetWindowWord(hwnd, GWW_HWNDPARENT); 

lpfnAccel = 

if (TranslateAccelerator(hwnd, 

MakeProcInstance(AcceleratorHook, hins); 

hmemAccel, (LPMSG)1Param)) 

lpfnAccelSav - 

return TRUE; 

SetWindowsHook(WH MSGFILTER, lpfnAccel); 

I 

) 

break; 

/* Create an instanced dialog proc address. */ 

} /* End switch message. */ 

) /* End if hmemAccel != NULL. */ 

Ipfnlnstance = MakeProcInstance(lpfnDialog, hins); 


/* Load up the dialog's accelerator table and */ 

IVal * DefHookProc(msgf, wParam, IParam, 

(FARPROC FAR *)&lpfnAccelSav); 

/* create the dialog. Save the previous */ 

return msgf < 0 ? LOWORD(lVal) : FALSE 

/* accelerator table handle, so we can restore */ 

1 

/* the previous instance of this routine, if */ 


/* any. */ 

/* End of File */ 

hmemAccelSav - hmemAccel; 


Module implements a Routine to Create a Dialog with an Accelerator Table 
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your app’s default data segment) near pointers, which are 
much faster, can be used. 

Also, in general, the 6lobal*() calls do a lot more work 
than their Local*() counterparts. 

2. You really need to profile. There could be a bottleneck in 
your code that might be made faster with a little tuning. 
Depending on circumstances, the adjustment could 
produce a dramatic overall speedup. 

3. Large memory model is generally a no-no for Windows ap¬ 
plications (not so with DLLs). It means only one instance of 
your application can be present at any one time. It will 
not improve your speed problem if the problem is caused 
by far pointer indirection. 

4. Yes, you can use based pointers (MSC 6.0 supports them), 
but once again, they are far pointers, so may buy you 
nothing. 

5. Absolutely. You can make sure that the DS_LOCALEDIT 
style is not used in any of your dialog templates. If you 
are creating an Edit I tern directly (i.e., via Create- 
UindowO), then make sure DS_LOCALEDIT is not used 
there either. In addition, allocate a block of global memory 
using GMEM_MOVEABLE \ GMEM_ZEROINIT and supply the 
handle as the value of the hlnstance parameter to 
CreateUindow(). 

6. If offloading local memory from the edits frees enough 
space, use it, since near pointers are much faster than 
far. Otherwise, profile version (b) and see if there is in¬ 
deed an execution bottleneck. 

Q How do you change the desktop cursor? 

many people 

A The desktop is implemented by a borderless window the 
size of the display. Its window handle can be obtained 
using the GetDesktopUindowf) call. Once you have the win¬ 
dow handle, you can use SetClassWord() with index 
GCU_HCURSOR to change the background cursor. Whenever the 
cursor is moved over a window, DefWindowProc() will set the 
cursor shape to the class cursor in response to the WM_SET- 
CURSOR message. 

As an example, the following code will set the desktop 
cursor to the four-headed resize cursor: 

SetClassWord(GetDesktopWindow(), 

GCW_HCURSOR, 

LoadCursor(NULL, IDC_SIZE)); 

Q This question came up during a discussion of screen 
capture programs. The problem arose when a technical 
writer needed to capture the image of each menu in an ap¬ 
plication under development. He was using the Print Screen 
key to capture the entire desktop to the clipboard, and then 
extracting the menu image using Paintbrush. He wanted a 
more automated method since there were many menus to 
capture. 

A Windows implements all top-level popup menus (i.e., 
those popup menus that are direct descendants of a 
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Listing 5 (menu.h) 

HWND HwndGetPopupMenu(HANDLE); 

VOID DrawMenu(HDC, POINT, HANDLE); 

/* End of File */ 


Interface to Popup Window Handle Module 


Listing 6 (menu.c) 


/* — Don't forget to export FEnumWnd() in your .def */ 
/* file! */ 

I ★*★*★*'*★★★★★***★*★★*★***★★**★★*★★★★★★★*★★★★★★**★★★★★* j 

/*****************************************************/ 
/* Header files. */ 


#include <windows.h> 
linclude "menu.h" 


Popup Menu Routines 


main menu bar) with a single window. This is a feasible solu¬ 
tion since only one top-level menu can be popped up at any 
one time. Once you have the popup menu window handle, 
Get DC () can be used to get a DC to use as the source of a 
BitBlt(). 
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Knowing the popup menu window handle can be generally 
useful. For example, in an application I am working on, we 
need to change the appearance of a popup menu while it is 
dropped. Just using ChangeMenuItemf) will not cause the 
menu to repaint itself to display the change. But if the win¬ 
dow handle is known, InvalidateRectf) followed by Update- 
Uindowf) can be used to force a repaint. 

Listings 5 and 6 implement two routines. HwndGetPopup- 
Menu() will return the common popup window handle. Draw- 
Menu () will copy the contents of a visible popup menu to a 
target DC at a given point 

HwndGetPopupMenu() uses EnumUindow() to search through 
all top-level windows looking for a window whose class name 
is #32768. This is the name USER registers the menu window 
class with. EnumWindows () uses a callback that gets invoked 
for each top level-window. FEnumWnd() is the callback to 
EnumUindows(). If the class of the current window is #32768, it 
saves the window handle and returns false to stop the 
enumeration. Make sure to put it in the EXPORTS section of 
the linker module definition file. 

Paul Bonneau 
bonneauOhyper.hyper.com □ 
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Listing 6 —Cont’d 


j*****************************************************j 

/* Private prototypes. */ 

/***************************************************** i 

BOOL FAR PASCAL FEnumWnd(HWND, DWORD); 

I*****************************************************j 

/* Routines. */ 

j*****************************************************J 

VOID 

DrawMenu(HDC hdc, POINT pt, HANDLE hins) 

y***************************************************** j 


/* -- Capture the popup menu if it ie visible. */ 
/* — hdc : DC to receive menu image. */ 
/* -- pt : Where to paint image in hdc. */ 
/* — hins : Application's instance handle. */ 


j ***************************************************** J 
{ 

HWND hwndMenu = HwndGetPopupMenu(hins); 

HDC hdcMenu; 

RECT rectMenu; 
int dx, dy; 

/* Hake sure popup menu is visible. */ 
if (IIsWindow(hwndHenu) || 
HsWindowVisible(hwndMenu)) 
return; 

/* Get a Dp for the menu, and copy its image. */ 
hdcMenu = GetDC(hwndMenu); 

GetWindowRect(hwndMenu, SrectMenu); 
dx = rectMenu.right - rectMenu.left; 
dy = rectMenu.bottom - rectMenu.top; 

BitBlt(hdc, pt.x, pt.y, dx, dy, hdcMenu, 0, 0, 
SRCCOPY); 

ReleaseDC(hwndMenu, hdcMenu); 

} 


HWND 

HwndGetPopupMenu(HANDLE hins) 

/************************★*****************★********** j 

/* — Find the window handle of the shared popup */ 
/* menu. */ 

/* — hins : Application's instance handle. */ 

I ***************************************************** j 

i 

FARPROC Ipfn; 

HWND hwndMenu = NULL; 

lpfn = MakeProcInstance(FEnumWnd, hins); 

EnumWindows(lpfn, (LONG)(WORD)&hwndMenu); 
FreeProcInstance(lpfn); 
return hwndMenu; 

) 


BOOL FAR PASCAL 


FEnumWnd(HWND hwnd, DWORD IParam) 


/* — EnumWindows() callback to get popup menu */ 

/* window handle. */ 

/***************************************************** j 
{ 


char szBuf[40]; 


GetClassName(hwnd, szBuf, sizeof szBuf); 
if (!lstrcmp(szBuf, "#32768")) 

{ 

*(HWND *)IParam = hwnd; 
return FALSE; 

I 

return TRUE; 

) 


/* End of File */ 
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Internationalization 



How To 

Compare Characters 
With European 
Collating Sequences 

Peter Gulutzan 


Quiz 

INPUT A$ 

INPUT B$ 

IF A$ > B$ THEN SWAP A$,B$ 

PRINT "The sorted result is: ",A$,B$ 

Will the above BASIC “sort program” always deliver the cor¬ 
rect answer? Specifically, will it print the results in dictionary 
order if the inputs are: (a) “x” and “y" (b) “Ch" and “Co”; (c) “oa” 
and “ob"? 

The answers are: 

(a) It depends what dictionary you use - in Lithuanian the 
letter x (which appears only in foreign proper names) comes 
after y (which is in the same place in the alphabet as i). 

(b) It depends what dirtionary you use - in Spanish every¬ 
thing that starts with ch comes after anything that starts with 
c alone. 

(c) It depends what dictionary you use - in German the 
order will be wrong because o and 6 are alphabetically 
equivalent; on the other hand the program would print an 
answer that’s correct for Hungarian, but for the wrong reason 
- not because it has the sophistication to tell, but simply be¬ 
cause the ASCII code for 6 is greater than the ASCII code for o. 

Check your score. If you got fewer than three correct 
answers, then you could be writing programs that look wrong 
to customers in Europe or even in North America (think of 
Mexicans and French Canadians). And the problem will arise in 
any program that sorts a list, creates an index, or retrieves 
with conditional selection - in other words, practically any 
business program. 


Peter Gulutzan (BA, MLS) is the president of Ocelot Computer 
Services Inc., a manufacturer of SQL database management 
systems. You mag contact him at #1104 Royal Trust Tower, 
Edmonton Centre, Edmonton, Alberta CANADA T5J 212. (403) 
421-4181. 
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Definition 

In a “collating sequence" we assign 
ordinal values to characters so strings of 
characters can be compared for pur¬ 
poses of correct sorting and indexing. 
“Correct” means the order should ap¬ 
proximate the alphabetical order of a 
local phone book or dictionary in places 
where the Roman alphabet, i.e., 
ABCDEFGHIJKLMNOPQRSTUVWXYZ, or a 
variant, is used. 

Not every character needs a dif¬ 
ferent value: where variants of a letter 
like 0 or o or o appear in the same 
place in the alphabet (we use the 
phrase “sorts with" or “maps with”), 
each variant has the same value. 

The program in the quiz was un¬ 
sophisticated, because it depends en¬ 
tirely on the ordinal values of ASCII. 
Even in English that’s not enough, since 
the lowercase letters follow the upper¬ 
case letters and thus a comes after Z - 
a flaw called “case sensitivity." So, for a 
minimum level of sophistication, the 
comparison statement should read: 

IF UCASE$(A$) > UCASE$(B$) 

THEN SWAP(A$,B$) 


Avoiding case sensitivity is about all 
that’s needed for English words, and it’s 
often as far as an English-oriented pro¬ 
gram goes, because attaining the next 
level of sophistication is much more 
complicated. You must: (a) determine 
the user’s language; (b) determine the 
machine's display capabilities; (c) con¬ 
struct a new ordinal sequence that can 
be derived efficiently from the original 
ASCII code. 

l will touch on all these problems, 
but my focus will be correct ordinal se¬ 
quencing. 

The Specific Problems 
To Look For In An Alphabet 

Six characteristics of non-English al¬ 
phabets make collating complex. 

Case 1: Accented characters that 
map to a plain equivalent 

The term “accent mark" or “accent” 
refers to any of the marks put on a 
character (usually just above it) to mark 
lengthening, softening, or accentuation. 
The word “diacritic” might be more cor¬ 
rect, but the MS-DOS manuals use “ac¬ 
cent mark” in this generalized sense. 

Some examples of accent marks are 
the French circumflex (as in e), the Ger¬ 


man umlaut (as in ii), or the Spanish 
emphasis mark (6). 

If you take the accent mark away 
from a character, you are left with the 
plain equivalent. Thus, 0 is the plain 
equivalent of 0. 

Usually a character with an accent 
sorts with the plain equivalent In this 
case, all you must do when you see the 
letter o is treat it as the letter o. 

Case 2: Accented characters that 
do not map to a plain equivalent. 

The Spanish letter N does not sort 
with N. instead N is a separate letter, 
falling between N and 0. 

In this case, you can’t simply treat N 
as N, because that would contradict the 
dictionary order (e.g., cana would incor¬ 
rectly precede cantina ). This “unmap- 
pability” leads to distinct problems, so 
such cases are a separate category 
from case 1. 

Some languages form a new charac¬ 
ter by putting a slash or dash through 
the letter, as in the Danish 0. Such char¬ 
acters never sort with the plain 
equivalent. 

Case 3: Characters that do not ap¬ 
pear at all in the English alphabet 

Because I’m talking only about al¬ 
phabets based on the ancient Roman 
characters, there are only four of these: 
the German fi (eszet), which sorts with 
SS (often one can avoid problems by 
simply typing SS instead of J3) ; the 
Danish/Norwegian ligature /E (usually 
translated as AE in English), which 
comes after Z; and the Icelandic “Eth" 
and “Thorn” characters. 

Case 4: Unexpected ordering. 

For example, in Lithuanian, Y sorts 
with /. 

Case 5: Two-character combina¬ 
tions. 

Every language has “digraphs,” in 
which two separate characters make a 
single sound. For example, English ch is 
a single sound. In a few languages, 
digraphs rate separate places in the al¬ 
phabet. The best known examples are 
in Spanish dictionaries, where (for in¬ 
stance) ch is a “letter” that follows c, in¬ 
stead of coming between eg and ci. 
Compare these orders: 

Spanish style: 

Calde 

Ciudad 

Corazon 

Chorizo 
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X 

69 
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e 
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u 
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+ 
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6 

♦ 

38 
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f 
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c 
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Z 
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A 
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S 

7 

• 

39 

' 
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G 
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g 
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9 
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z 
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a 
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s 

X 

D 

40 
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72 

H 
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h 
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\ 
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S 

200 

0 
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R 

9 

O 

41 
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73 

I 
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i 
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e 
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5 
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If 
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U 

10 

E 

42 

•** 

74 

J 
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j 
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0 
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202 

ji 

234 

r 

II 

6 

43 

+ 

75 

K 

107 

k 

139 

6 

171 

z 

203 

ii 

235 

U 

12 

? 

44 


76 

L 

108 

1 
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l 

172 

C 

204 

1! 

236 

y 

13 

r 

45 


77 

M 

109 

m 
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Z 

173 
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205 

= 

237 

¥ 

14 

n 

46 


78 

N 

no 

n 

142 

A 

174 

« 

206 

ji 

11 

238 
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* 

47 

/ 

79 

0 
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0 
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C 
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» 
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a 

239 


16 

► 

48 

0 

80 

P 
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P 
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E 
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;lil 
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d 
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- 

17 

< 

49 

1 

81 

Q 
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q 
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L 
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I 
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D 
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" 

18 

t 

50 

2 

82 

R 
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r 

146 

l 
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1 
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D 
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V 

19 

!! 

51 

3 

83 

S 

115 

s 

147 

6 

179 

1 

211 

E 

243 


20 

H 

52 

4 

84 

T 

116 

t 

148 

o 

180 

j 

212 

d 

244 


21 

§ 

53 

5 

85 
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117 

u 

149 

L 

181 

A 

213 

N 

245 

§ 

22 

- 

54 

6 

86 

U 

118 

u 

150 

I 

182 

A 

214 

I 

246 

T 

23 

1 

55 

7 

87 

U 

119 

u 

151 

s 

183 

E 

215 

I 

247 


24 

t 

56 

8 

88 

X 

120 

X 
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s 

1X4 

§ 

216 

e 

248 

• 

25 

i 

57 

9 

89 

Y 

121 

y 
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b 

185 

il 
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J 
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26 

-» 

58 


90 

Z 
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z 
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U 
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il 
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r 
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• 

27 

«- 

59 


91 

[ 
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T 
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il 
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1 
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u 

28 

l_ 

60 

< 

92 

\ 
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1 

156 

t 

188 

ii 

220 

■ 

252 

R 

29 


61 

= 

93 

] 

125 

> 

157 

L 

189 

z 

221 

I 

253 

r 

30 

A 

62 

> 

94 


126 

~ 

158 

X 

190 

z 

222 

u 

254 

■ 

31 

▼ 

63 

? 

95 


127 

£t 

159 

c 

191 

1 

223 

■ 

255 
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English Style (incorrect): 

Calde 

chorizo 

Ciudad 

Corazon 

Combination specials happen only in 
Spanish, Hungarian, Czech, Albanian, Lat¬ 
vian, Croatian, Slovak and Welsh. But 
treating two characters as a single char¬ 
acter causes more trouble than accent 
marks, special characters, and unex¬ 
pected orderings. 

Case 6: Variant character forms. 

By this I mean the just-like-in-English 
obvious but important detail: case. Up¬ 
percase A sorts with lowercase a in 
every European alphabet 

How MS-DOS Tries To Help, 
And Fails 

In all languages, uppercase and 
lowercase A through Z are firmly 
defined in the first 127 codes of the 
ASCII character set The codes from 128 
to 255 are additions by IBM, "the IBM 
extended ASCII character set.” All ac¬ 
cented characters belong to the ex¬ 
tended set. The code listing can be 
found in the back of any IBM Technical 
Reference manual. You reasonably ex¬ 
pect that the IBM extended character 
set will be the default on most 
machines. 

On older PCs with monochrome 
monitors, national-language accented 
character variations were burned into 
the computer depending on where it 
was bought; flexibility came as graphic 
capabilities got better and awareness of 
other languages increased. Since MS- 
DOS v3.3, Microsoft has supported alter¬ 
native characters via “code pages” for 
various national languages. Provided 
your display is EGA or better, code 
pages are a wonderful enhancement to 
display flexibility, making the switch 
from one character set to another rela¬ 
tively easy. 

The following code pages concern 

US: 

• 437 - Default - Equivalent to the 
IBM extended character set. Always 
the norm in the USA, usable in 
many other countries. 

• 850 - International - Contains more 
characters than code page 437, at 
the expense of some graphics. 
Recommended by Microsoft as 
usable with all West European lan¬ 


guages, including Portuguese and 
Nordic. 

• 852 - East European (see Table 1). 

• 860 - Portuguese. 

• 861 - Icelandic. 

• 863 - Canadian French. Differs by in¬ 
cluding accents for uppercase charac¬ 
ters, which are not used in 
European French. Not recommended. 

• 865 - Danish/Norwegian. Sometimes 
called “Nordic". Differs from 437 by 
adding the character 0 ,0 (extended 
ASCII codes 157 and 155). 

There is no room to replicate each 
code page in this article, but except for 
code page 852 (Eastern European), all 
code pages are readily found in any MS- 
DOS reference text Code page 852 for 
Eastern Europe is included here (see 
Table 1). (Note: code page 852 is a new 
addition to the repertoire; the easiest 
way to get it is with the latest MS- 
DOS/DR-DOS.) 

With the introduction of code tables, 
MS-DOS 3.3 solved the display problems 
caused by variant alphabets. Language 
support goes further: you can access 
what Microsoft calls a “collating table,” 
which (in their words) “maps uppercase 


and lowercase ASCII to the same collat¬ 
ing codes (so that sorts will be case in¬ 
sensitive) and maps accented vowels to 
their plain vowel equivalents." Although 
the description says “vowels," some 
consonants, such as C, are mapped as 
well. 

Listing 1 shows how this could be 
used in an assembler program. In Listing 
1, we switch to the Danish/Norwegian 
character set and translate the letter 0 
to its collating-code equivalent You will 
need MS-DOS 3.3 or later and a monitor 
with EGA or better. Any MS-DOS refer¬ 
ence manual will have a detailed and 
interesting description of function call 
65h. 

Using code pages has two ad¬ 
vantages: it’s simple, and the translated 
result is still a displayable string. There 
is one disadvantage: using code pages 
doesn't work. The program in Listing 1 
tells us that the collating code for <5 is A 
but in fact d follows Z in the Danish al¬ 
phabet! This is not an isolated example. 
Microsoft’s method fails for most 
European languages, with some happy 
exceptions like French and Italian. 


The Measure of 
a Great Program. 

PC-METRIC™: The Measurement Tool For Serious Developers. 

PC-METRIC is the software measurement tool 
that measures your code and identifies its most 
complex parts. So you can spend your time 
working in the areas most likely to cause 
problems. 

PC-METRIC is fast, user-configurable, and 
includes a wide array of commonly accepted 
measurement standards. 

Plus, versions of PC-METRIC are available to 
support virtually every popular programming 
language. 

A Great Value By Any Measure. 

PC-METRIC’s price is only $199, and it comes 
with a 30-day money-back guarantee. Multiple 
user discounts are available, as well as site 
licenses and complete source code. 

Order Now! Call (503) 829-7123. 


COMPUTER 

LANGUAGE 




SET LABORATORIES, INC. 

"Quality Tools For Software Craftsmen" 
P.O. Box 868 
Mulino, OR 97042 
Phone: (503) 829-7123 
FAX: (503) 829-7220 
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MS-DOS 3.3 and 4.0 did only what 
the manual says, and no more: they 
mapped lowercase ASCII and accented 
lowercase ASCII and accented charac¬ 
ters to their plain equivalents. Such 
mapping suffices for case 1 (accented 
characters that map to a plain 
equivalent), case 4 (unexpected order¬ 
ing), and case 6 (variant character 


forms). With case 2 (accented characters 
that have no plain equivalent), case 3 
(characters that do not appear at all in 
the English alphabet), and case 5 (com¬ 
bination specials), we bump against 
brutal reality: there is no plain 
equivalent to map to. Nor is there room 
to add an equivalent (MS-DOS 5.0 fixes 
this by allowing mapping anywhere in a 


256-code range, but thus loses the sup¬ 
posed readability advantage). 

For German, the deviation affects 
only one special character (3), and Ger¬ 
mans can tolerate seeing SS instead of 
3. By the time one reaches the next- 
closest fit, Spanish, the situation has be¬ 
come unacceptable: three letters are 
wrong (CH, LL, N). In Swedish three other 
letters are wrong (A, A, 0). And so on. 

In the following section I address the 
commonly accepted collating sequen¬ 
ces. Every one of the continental al¬ 
phabets (except French, Italian, and Por¬ 
tuguese) contains a "gotcha” that makes 
the uppercase mapping method unac¬ 
ceptable. 

The Great Alphabets 
Of Europe 

In Table 2, I present all the pitfalls 
that I am aware of for every alphabet 
frequently used in Europe, except the 
non-Roman (Cyrillic and Greek) al¬ 
phabets. 

Accented characters are present in 
every language except English, but 
won't be mentioned unless they 
present a problem that cannot be 
solved by simple mapping, i.e., where 
the character is not displayable using 
any code page, or where the use of an 
accent affects alphabetical order. For 
example, in the discussion of German o 
is omitted because it maps to o, but it 
is discussed for Turkish and Flungarian, 
where no such mapping is possible. 
Treat all accented characters in a code 
page as mappable to their uppercase 
plain equivalents, unless the discussion 
mentions a specific pitfall. 

Many alphabets lack English charac¬ 
ters such as Q or X, but I ignore that 
fact (since the entire English alphabet is 
always present in ASCII), unless the 
English character would not be in 
regular order. 

In all cases, the “suggested code 
page” is the one that appears to be the 
best fit for the display characteristics. 
The suggested code page may not 
reflect current common usage in some 
countries, especially in Eastern Europe, 
where code page 852 is not always 
available for older computers or operat¬ 
ing systems. In all cases where code 
page 437 is suggested, 850 will do. 


Listing 1 


(1) Change CONFIG.SYS to this (assuming \dos is on drive C): 
country=002,,c:\dos\country.sys 

device=c:\dos\display.sys con=(ega,,2) 

(2) Change AUTOEXEC.BAT to this: 
nlsfunc 

mode con codepage prepare=((863,850) c:\dos\ega.cpi) 
chcp 850 

(3) Reboot. 

(4) Create, assemble and execute this program: 

Program: Given a certain accented character, return the 

plain equivalent via a code page collating table. 
Author: P. Gulutzan, Ocelot Computer Services Inc. 

Note: Requires MS-DOS 3.3 or later. 

This program was originally prepared with MS-DOS 4.0. 
One would probably want to do a few things differently 
with MS-DOS 5.0 or DR-D0S 6.0. 


d_cseg 

assume 


segment byte public 'CODE' 
cs:d_cseg 


db 6 (0) 


start: 

;MS-D0S 3.3 function: 


‘Get pointer to collating sequence table” 


ax,6506h 

bx,-l 

cx,512 

di,offset d_cseg:xx 

si.seg d_cseg 

es,si 

dx,-l 

21h 


;codepage of interest = default 
;length of receiving buffer 
;doubleword pointer to buffer 


;country of interest = default 


mov 
mov 
mov 
mov 
mov 
mov 
mov 
int 

A failure here would probably indicate that CONFIG.SYS 
and/or AUTOEXEC.BAT were not set up properly, in which case: 
no display. 

jc endit ;{failure) 

At this point xx has: 

Byte The subcode passed in AL for the function call: 06h 

Dword The address of the collating sequence table 

les di,es:[di+l] ;Point to the table 

Now es:di points to the collating sequence table, which has: 


Word 
Byte(s) 
mov 
mov 
mov 
int 

endit: 

mov 

int 

d_cseg ends 
end start 


Number of characters. Will be < 256 if truncated. 
A lookup table for each character 


bx,134 

dl ,es:[bx+di] 

ah,2 

21h 

ah,4ch 

21h 


;= the code for a + degree-sign 
;look it up in the collating table 
;display it 


;stop 


(5) Observe that the result is the letter “A" (ASCII code 65). 

(6) Restore the original CONFIG.SYS and AUTOEXEC.BAT files. 


An International Sort Example Program 
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Coding The 

Collating-Sequence Tables 

For each of the alphabets presented 
in Table 2, the translation into a 
programming language equivalent is 
straightforward. As a convention, I sug¬ 
gest reserving the value 0 for “un¬ 
known” and replacing all spacing or 
punctuation or graphic characters with 
1. Then assign the ordinal value 2 to 
the first character in the alphabet, 3 to 
the second character in the alphabet, 
and so on. These assigned values are 
the collating codes. 

Enter the collating codes into a 255- 
byte table that corresponds to the code 
page currently in use. The values 
returned by the MS-DOS collating tables 
are a good starting point. Simply ex¬ 
amining the displayed characters makes 
it clear. 

Unfortunately, you cannot assume 
that a particular character always has 
the same value on different code pages. 
To avoid excessive coding for rare situa¬ 
tions, use the most appropriate code 
page for each language - usually 437, 
the IBM extended character set 


For some languages, you also need a 
two-character table with an indication 
of the collating code. Such tables are 
short enough to search sequentially. For 
example, in the Spanish table CH would 
be 4. 

The tables are included in Listing 2 
(tech.c) on the code disk. 

A Translation Routine In C 

Listing 3 is the essential routine for 
translating a string of characters into 
their collating-code equivalents. The in¬ 
itialization procedure will vary depend¬ 
ing on the objective, so pick an ap¬ 
propriate alternative. 

• Alternative 1: Use MS-DOS function 
INT 21 h with AH=65h, AL=01H. This 
returns, among other things, the 
country code and the current code- 
page number, which we use to 
decide what collating-sequence 
table to use. 

• Alternative 2: Ask the user what 
table to use. 

• Alternative 3: Hard-code the table. 

• Alternative 4: Use the same table as 
last time, given that you stored the 
information in a file last time. Use 


this especially if you made a per¬ 
manent index file. 

Considerations For indexers 

I’ve discussed only the translation 
procedure, and not the larger program 
that will use it —for sorting, indexing, or 
conditional lookups (i.e., in SQL terms, 
“WHERE clauses”). The translation proce¬ 
dure should fit easily and obviously into 
larger programs without affecting much 
else. Whenever a string comparison 
takes place, translated strings must be 
compared, rather than the original 
strings. In a sort or a lookup, this is 
transparent because the user has no 
need to look at the results of inter¬ 
mediate steps. 

With a file of index keys, using the 
translation procedure is not quite 
transparent. You have to account for 
the following possibilities: users from 
different language areas might swap 
files-, organizations might have a stand¬ 
ard for indexes (must look readable or 
be dBASE-compatible, etc.); the user or 
the user's computer might be multilin¬ 
gual. 

(text continued on page 18) 



of the Way CONFIG.SYS Boots You Around? 

Then Give Your CONFIG.SYS the Boot~With BOOTCON. 

". . . its bulletproof ... The interface is well thought out. You need this program." 
Dr. Jerry Pournelle, Byte, July 1990 

"Highly recommended." 

John C. Dvorak, PC Magazine, July 1990 

How many CONFIG.SYS and AUTOEXEC.BAT combinations do you have on your 
PC? BOOTCON eliminates the confusion by storing all your configuration 
information in just one set of configuration files. Each time you boot your PC 
you can select the configuration you want to use from a menu of up to 26 
choices. 

BOOTCON is ideal when you need to use conflicting programs such as Windows 
3.0, QEMM/386, 386max, Soft-ICE, and Lotus 123. A default configuration will 
automatically be used if you do not make a selection within the specified time-out 
period. BOOTCON also provides an optional password protection feature. 

BOOTCON lists for $59.95. 



! MODULAR 


SOFTWARE SYSTEMS 


(818) 440-9104 FAX (818) 440 9240 

115 W. California Blvd. Suite #113, Pasadena, CA 91105 


i'A 1 




BOOTCON comes on both 5 1/4" and 3 1/2" disks. It has an unconditional 30-day money-back guarantee. MS-DOS or PC-DOS 3.10 or later is required. 

Windows and MS-DOS are trademarks of Microsoft Corporation. PC-DOS is a trademark of International Business Machines Corporation. QEMM/386 is a trademark of Quarterdeck Office 
Systems. 386 MAX is a trademark of Qualitas Corporation. Soft-ICE is a trademark of Nu-Mega Technologies. Lotus and 123 are trademarks of Lotus Development Corporation. 


□ Request 186 on Reader Service Card □ 


January 1992 


Windows/DOS Developer’s Journal — Page 15 








Table 2 

Albanian 

Q follows C. DH follows D. E follows E. GJ follows G. LL follows L. NJ follows N. RR follows 
R. SH follows S. TH follows T. XH follows X. ZH follows Z. Suggested code page: 437. 

Croatian 

C follows C. C follows C. DZ follows D. -6 follows DZ. LJ follows L. NJ follows N. S follows 

S. Z follows Z. Suggested code page: 852. 

Czech 

y V 1 i V 

C follows C. E may follow E. CH follows H. R may follow R. S follows S. Z follows Z. 

Suggested code page: 852. 

Danish 

£ follows Z. 0 follows £. A follows 0. Suggested code page: 865. Code page 850 will do. 

For old Danish names AA sorts with A, e.g., Aarhus = Arhus. 

Dutch 

No special problems. Proper Dutch does have one digraph U, which is sometimes used for Y, but 
it is acceptable to use IJ and sort with IJ. Suggested code page: 437. 

Esperanto 

i follows C. 6 follows G. ft follows H. ft follows J. § follows S. U follows U. Suggested code 

Y ¥ 

page: custom. Code page 852 has C and S (using hacek rather than circumflex). 

Estonian 

The last letters of the alphabet are : S, S, Z, Z, T, U, V, W, 0, A, 0, U, X, Y. Suggested 
code page: 850. 860 will do. Do not use 852 ("Eastern European"), since it lacks a code for 0. 

Finnish 

A follows Z. 0 follows A. Suggested code page: 437. 

French 

No special problems. Suggested code page: 437. 

German 

p is the same as SS. Note: phone books in Germany sort A, 0, and 0 with AE, OE, and UE 
respectively, and Austrian phone books sort these letters just after AZ, 0Z, and UZ. Swiss 
phone books and all German dictionaries simply map them to their plain equivalents, so there 
are no special problems in most situations. Suggested code page: 850. 

Hungarian 

A may follow A. CS follows C. E may follow E. 0 follows 0. U follows U. ZS follows Z. The 
digraphs GY, LY, NY, SZ and TY are separate characters, but they follow G, L, N, S, and T 
anyway. Suggested code page: 850. 

Icelandic 

•6 follows D. p follows Z. £ follows £ • 0 follows £. Suggested code page: 850 (861 

"Icelandic" isn't necessary). 

Italian 

No special problems. Suggested code page: 437. 

Latvian 

A follows A. C follows C. CH follows C. DZ follows D. E follows E. § follows G. I follows I. 

IE follows T. I£ follows K. (. follows L. Ijl follows N. S follows S. U follows U. Z follows Z. 

Suggested code page: custom. Code page 852 comes closest, but does not allow for A, E, I, U, 
<*. or (.. 

Lithuanian 

¥ ¥ 

C follows C. Y is the same as I. S follows S. X follows Z. Suggested code page: custom. Code 

page 852 comes closest, but does not allow for (, U, or l). 

Norwegian 

See Danish. 

- 
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Table 2 — Cont’d 

Polish 

^ follows A. C follows C. £ follows E. t follows L. 0 follows 0. S* follows S. Z follows 
Z. Z follows Z. Suggested code page: 852. 

Portuguese 

No special problems. Suggested code page: 860. 

Romanian 

U /\ 

A may follow A. I follows I. § follows S. J follows T. Suggested code page: 852. 

Slovak 

C follows C. CH follows H. S follows S. Z follows Z. Suggested code page: 852. 

Slovenian 

C follows C. S follows S. Z follows Z. Suggested code page: 852. 

Spanish 

CH follows C. LL follows L. N follows N. Suggested code page: 437. 

Swedish 

A follows Z. A follows A. 0 follows A. Suggested code page: 437. 

Turkish 

$ follows C. G follows G. i follows I. 0 follows 0. § follows S. U follows U. 

Suggested code page: custom. The standard code pages, even code page 852, 

U 

do not allow for the letters G or I. Code page 857 "Turkish" is available but not 
universal. 

Welsh 

CH follows C. FF follows F. LL follows L. PH follows P. RH follows R. TH follows T. 
Suggested code page: 437. 


AccSys" for 



■ Set of C libraries for easy access 
to dBASE data and index files. 

■ Source available but not required. 

■ Increased performance shortens 
processing time. 

■ Total control over data memo, MDX 
and NDX index files. 

■ Network and single-user versions available. 

Copict International Ltd. 

1964 Richton Drive, Wheaton, Illinois 60187 
708/ 682-8898 FAX: 708/665-9841 

Instant info, via FaxFacts: 708/924-7465 Press: 889837# 


Faxracts 

COPIA-INTERNATIONAL 



introducing the 
Fax-on-Demand 
System That’s 
Above and Beyond The Call. 


Immediately respond to your customer’s needs 
with FaxFacts' Fax-on-Demand. Be there with on- 
the-spot tech support, late breaking news, and 
sales and marketing information without adding 
another member to your staff! 


■ Inexpensive one-call and 
full-featured call-back 
delivery methods. 

■ Switch between one-call 
and call-back configura¬ 
tions dynamically. 

■ Password protection for 
system entry & images. 


■ Utilize images & messages 
on line-by-line basis for 
Service Bureau. 

■ Auto charge feature verifies 
credit card, debits account, 
issues receipt. 

■ Additional features include 
Broadcast, DID, up to 
4128 lines. 


TRY THIS DEMO: 708/924-7465 DOC. NO. 889817 

Copia International. Ltd , Wheaton, IL 60187. Voice 708/682-8898 FAX 708/665-9841 

Dealer Inquiries Welcome 
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Listing 2 (tech.c) 

/* tech.c 


An "international" sort example program. 

Author: 

Peter Gulutzan, Ocelot Computer Services Inc. (403) 421-4187 

Date: 

March 17, 1991 

For: 

TECH Specialist 

Language: 

C (tested with Borland C++ and Zortech C++ compilers) 

(If compiling with Zortech: remove the "linclude <mem.h>" line) 

Remarks: 

This program will ask the alphabet to use. Then it opens the 
file INPUT.TXT, translates the strings in it to coded 
tags, sorts with the standard qsort() routine supplied by the 
compiler manufacturer, and outputs to file 0UTPUT.TXT. 

Limits: 

Tags are chopped to be a maximum 20-character size: MAXTAGSIZE. 

Only Characters are sorted. Digits and punctuation go low. 

The maximum number of tags is 1000: MAXTAGS. 

QsortO requires that all the tags be in RAM. 

Note: 

This only covers a few sets (French, Danish, German, Polish 
and Spanish) to show how it can be done. */ 

linclude <stdio.h> 
linclude <stdlib.h> 

linclude <string.h> 

linclude <mem.h> /* Remove this line if compiling with Zortech */ 

Idefine MAXTAGS 1000 

Idefine MAXTAGSIZE 20 

Idefine M 

(MAXTAGSIZE) 

Idefine FRENCH 0 

Idefine DANISH 1 

Idefine GERMAN 2 

Idefine POLISH 3 

Idefine SPANISH 4 

/* Definitions of plain-text equivalents. 

Note how we leave interstices, e.g. A=3, B=6, C=9 etc. */ 

Idefine 

1 /* "unknown" or blank */ 

Idefine A 

+2 

Idefine B 

A +3 

Idefine C 

B +3 

Idefine D 

C +3 

Idefine E 

D +3 

Idefine F 

E +3 

Idefine G 

F +3 

Idefine H 

G +3 

Idefine I 

H +3 

Idefine J 

I +3 

Idefine K 

J +3 

Idefine L 

X +3 

Idefine M 

L +3 

Idefine N 

M +3 

Idefine 0 

N +3 

Idefine P 

0 +3 

Idefine Q 

P +3 

Idefine R 

Q +3 

Idefine S 

R +3 

Idefine T 

S +3 

Idefine U 

T +3 

Idefine V 

U +3 

Idefine W 

V +3 

Idefine X 

W +3 

Idefine Y 

X +3 

Idefine Z_ 

Y +3 

/* The first 128 characters are always the same as defined in 7-bit ASCII. 

Note how we use leave interstices, e.g. A=3, B=6, C=9, etc. */ 

char base[128]= {0, _, _, _, _, _, _, _, _, _, 

*»»»»»»»»» 

********** 


********** 

********** 

* * * * * A , B , C , D , E , 


G, H, I, J, K , L, M, N, 0, P, 


Taking such situations into account, 
the documentation of the character-set 
choices should be supplied with any 
package. Packages should allow for 
changing collating sequence regardless 
of country or code page, and perhaps 
should store key values in the original 
untranslated state, despite the over¬ 
head involved. 

Some Current Packages 

Most ISAM or data-management sys¬ 
tems on the market have little support 
for the variation in character sets. Most 
packages simply sort by the unmas¬ 
saged ASCII value. I have seen a claim 
that Emerald Bay supports foreign lan¬ 
guage characters “to the full extent al¬ 
lowed by the IBM extended ASCII char¬ 
acter set." I have heard that Paradox at 
least takes the existence of code pages 
into account. 

I have seen ads in German 
magazines for a product called “Topaz" 
(possibly the same as the Pascal library 
advertised in US magazines by Software 
Science Inc.), emphasizing that the 
package can handle umlauts. The only 
notable point is that the advertisers 
think this capability is worth mention¬ 
ing, and that the German language has 
a new word for the process: Umlautsor- 
tierung. 

I've criticized MS-DOS; now here’s 
something it deserves a pat on the 
back for. Judging from the manual, the 
ISAM subsystem in Microsoft's Profes¬ 
sional Development System correctly 
supports Spanish and all the Scan¬ 
dinavian languages. In fact, Microsoft ex¬ 
tends the process described here, in 
two ways. First, Microsoft allows Y = IJ 
in Dutch. Second, they guarantee the 
correct order for a case, which I have 
disregarded: the word a follows the 
word a in a French dictionary, suggest¬ 
ing that if and only if the different char¬ 
acter is the last character in the string, 
the accented character follows the plain 
character. 

A curious situation arises in compar¬ 
ing two main types of DBMS: dBASE 
clones and SQL. I do not know of any 
explicit support for foreign character 
sets by dBASE clones. dBASE IV does 
allow indexing on the uppercase 
equivalent of a string, and I've heard 
that Clipper can index on a .UDF - 
which apparently means one can call a 
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Listing 2 —Cont’d 

P . Q 

, R, s, T, U, V, W, X, Y, 

Z , 

» * » 9 9 9 A , B , C , 

D , E 

» G , H , I, J, K , L, M , 

N , 0 

. P, Q. R. S, T. U, V, W, 

X , Y 

»Z, , » , * }» 

/* Extended characters f 

or French (assumes code page 437) */ 

char fren[128]={C , U 

• 

E , A 

» A , A , A , C , E , E , E» 

I . I 

* A , A , E , » ,0,0,0, 

U , U 

, Y , 0 , U , , , , , , 

A_, L 
» 

> 

, 0_, U_, N_, N_, 

>99999999 

999999999 

» 

_» _ 

> 

» 

999999999 

9 _» _ 9 _> _> _» _> _» _t 

999999999 

999999999 

999999999 
\ . 

_ 9 _ 

/* Extended characters f 

9 _> _> _> _/ 9 

or Danish (assumes code page 865) 

NB: Some provision is 

made for other Scandinavian sets, e.g. 231 

would be the Icelandi 

c thorn if you were using code page 861. */ 

char dani[128]={C , U 


E , A 

,5+Z , A ,4+Z , C , E , E , E , I , 

I , I 

,5+Z ,4+Z , E ,2+Z ,2+Z , 0 ,6+Z , 0 , 

U , U 

, Y ,6+Z , U ,3+Z , ,3+Z , 

A_. I_ 

> 

0_, U_, N_, N_, _, _, _, 

1 1 1 1 1 > 1 1 1 

999999999 

_ 9 _ 

_» _ 

» 

_» _ 9 _» _> _» _» _> _• 

» _, _» _ 9 _I _» _ 9 9 

999999999 

zii + Z 

>99999999 

9 

»»»»»»»»» 

\ . 

_» _ 9 _1 _ 9 _ 9 _ I 9 

/* Extended characters for Spanish (assumes code page 437) */ 

char span[128]={C , U 


E , A 

A, A, A, C, E, E, E , I, 

I , I 

A , A , E , , ,0,0,0, 

U , U 

Y , 0 , U , , , , , , 

A _. L 

_ 9 _ 

0_, U_,l+N_,l+N_, _, _, _, _, 

_ 9 _> _ 9 _> _ 9 _» _, _ 9 

9 

9 

9 

999999999 

999999999 

999999999 

9 

9 

999999999 

999999999 

9 

9 

99999999 

9 9 9 } » 

/* Extended characters for Polish (assumes code page 852) */ 

char poli[128]={C , U 


E . A 

A , U ,1+C , C ,1+L , E , 0 , 0 . 

I ,1+Z 

A ,1+C , E , L , L , 0 , 0 , L , 

L ,1+S 

,1+S , 0 , U , T , T ,1+L , X , C , 

A . I 

,1+0 , U ,1+A ,1+A , Z , Z ,1+E ,1+E , 

,1+Z 

*c,s, , , , , , , 

, A 

A , E , S , , , , ,2+Z , 

3+Z , 

, 9 9 9 9 9 A , A , 

> 

, , , , , »D,D, 

D , E 

,D,N,I,I,E, , , , 

, T 

u , ,1+0 , , 0 , N , N , N , 

S , S 

R , U , R , U , Y , Y , T , 

» 

u_ 

»»*»*»♦» 

R_» R_, _ 9 _} 9 

char code set [256]; 

/* e.g. = base + lanOO sets. */ 

unsigned int language; 

/* 0=FRENCH, 1=DANISH , 2=SPANISH, etc. */ 

int comp function (const void *a, const void *b); 

int getline(FILE *fp,char 

*a,const unsigned int b); 


- New Version 4.0 \ 

Commenting Disassembler! 


SOURCER, 486 


□ See how programs work 

□ Easily modify programs 

"Sourcer is the best disassembler 
we've ever seen." PC Magazine 


SOURCER ,m creates commented source code 
and listings from executable files or memory, 
suitable for reassembly. Sourcer helps clarify 
the inner workings of programs, with detailed 
in-line comments on interrupts, subfunctions, 
I/O ports functions, and much more. It offers 
complete support for all 8088/87 to 80486 
instructions and V20/V30. 

Sourcer provides the most comprehensive 
automatic analysis available to accurately 
separate code and data. It determines data 
types, uses descriptive labels for BIOS and 
PSP data, and links data items across multiple 
segments. Now supports MASM 6.0, TASM 
and DOS 5.0. 

Professionals consistently chose Sourcer 
because of its ability to achieve far superior 
results with the least effort. 


BIOS SOURCE 


for PS/2, AT, XT, PC and Clones 

□ Change and add features 

□ Clarify Interfaces 

The BIOS Pre-Processor M augments Sourcer 
to obtain commented listings for any BIOS 
ROM in your PC. Now you can understand 
how your specific BIOS works. Adds over 75K 
of comments specific to your BIOS. Tracks 
and identifies multiple interrupt branches with 
special labeling such as "int_10_video." Full 
automatic operation. 


ASM ProPak 


Combine our advanced assembly language 
tools and save up to $120! All ASM ProPaks 
include Sourcer & the BIOS Pre-Processor, 
Unpacker ™ for unpacking packed EXE files, 
and View-lt “ the highest speed file viewer 
providing a 132 colum display. ProPak II adds 
ASMtool ” 486 to flow chart 8088 to 80486 
source code. ProPak III adds ASM Checker the 
only assembly source code bug finder. 

Sourcer 486 Commenting Disassembler $129.95 


BIOS Pre-Processor 49.95 

Sourcer w/BIOS - (save $10) 169.95 

Unpacker - Unpacks packed files 39.95 

View-lt - View 132 column files 69.95 

ASM ProPak I - All above (save $40) 249.80 

ASMtool 486 - Automatic flowcharter 199.95 
ASM ProPak II - All above (save $90) 399.75 

ASM Checker - Finds source code bugs 179.95 
ASM ProPak III - All above (save $120) 549.70 

Memory Commander - Get up to 920K 99.95 

of low DOS memory and much more! 


Shipping: USA $6; Canada/Mexico $10; Other $18. CA residents 
add sales tax. © 1991 VISA/MasterCard/COD accepted. 

30-DAY MONEY-BACK GUARANTEE 

1-800-648-8266 



V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 275-TS2 
San jose, CA 95129 FAX 408-296-4441 
408-296-4224 


January 1992 


Windows/DOS Developer's Journal — Page 19 














































































Listing 2 — Cont’d 

void translate (char *s,char *t,unsigned int language,const unsigned int b); 
void putline (FILE *fp,char *s); 

int main () 

{ 

unsigned int i,j; 

FILE *fopen(),*ifp,*ofp; 

char tagarray[MAXTAGS * (MAXTAGSIZE+4)]; 

char s[255]; 

char *t; 

language=get_language(); /* Get language */ 

memcpy(code_set,base,128); /* Create code set */ 

switch (language) { 

case FRENCH: memcpy(code_set+128,_fren,128); break: 
case DANISH: memcpy(code_set+128,_dani,128); break; 
case GERMAN: memcpy(code_set+128,_fren,128); break; 
case POLISH: memcpy(code_set+I28,_poli,128); break; 
case SPANISH: memcpy(code_set+128,_span,128); break; ) 
ifp=fopen("INPUT.TXT l, ,"r“); /* Open input file */ 

for (i=0,t=tagarray; i<MAXTAGS; ++i,t+=MAXTAGSIZE+4) {/* Loop: */ 
t+=M; *((long int *) t)=ftel1(ifp); t-=M; /* Save orig pos */ 

if (getline(ifp,s,sizeof(s))<0) break; /* Read, stop @eof */ 

translated,t,language,MAXTAGSIZE); } /* Codify. */ 

if (i==MAXTAGS) printf("Only sorting 1000 records\n"); 
qsort((void *)tagarray,i,MAXTAGSIZE+4,comp_function); /* Standard sort! */ 
ofp=fopen(“OUTPUT.TXT","w"); /* Open output file */ 

for (j=0,t=tagarray; j<i; ++j,t+=MAXTAGSIZE+4) { /* For each tag */ 

t+=M; fseek(ifp,*((long int *) t),0); t-=M; /* Find original */ 

getline(ifp,s,sizeof(s)); /* Read original */ 

putline(ofp.s); } /* Write new */ 

printf("Done.\n“); 
return (0); } 



Sure - you can learn graphical user 
interface programming by the book. 


But you can save time and money by 
attending our workshop. 


HEtp! 


It can take up to a year just to wade through all the manuals 
needed to leam GUI programming. We will 
have you writing a professional application 
immediately upon finishing one week of our 
intensive, hands-on training. 


Descriptor Systems has been teaching pro¬ 
gramming classes at companies like IBM 
since 1983. Our catalog includes: 

Microsoft Windows Programming and OS/2 
Presentation Manager Programming. 


Contact us for more information 
on these and other programming 
workshops. 


Descriptor Systems 
P.O. Box 461 
Marion, IA 52302-9909 
Phone: 319-362-3906 
Fax: 319-362-3701 
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C routine to translate a key before in¬ 
serting it in an index. 

SQL systems have a problem here: 
the standard syntax is presented to ap¬ 
plication programmers at such a high 
level that they cannot modify or bypass 
the defaults that the manufacturer puts 
into the CREATE INDEX statement. 
dBASE clones can modify collating se¬ 
quences because the ANSI standard 
says only that “comparison is made 
with respect to the implementor- 
defined collating sequence.” 

There are ways around the SQL 
limitation (e.g., translating the actual 
data field, or using a DB2-like EDITPR0C 
clause). But SQL vendors must attack 
head-on, with explicit high-level support 
for national character sets. In fact, ANSI 
is already circulating a draft for SQL/2, 
where explicit qualification is part of the 
syntax, e.g., 

CREATE TABLE T (SI CHAR(40) 

CHARACTER SET IS <set-name>); 

where <set-name> can imply a collating 
sequence that's been defined by either 
the implementor or the user. Currently, 
the SQL/2 specification is just a wishlist. 
But vendors who can partially support 
CHARACTER SET have an obvious ad¬ 
vantage in foreign markets. 

Recent Improvements 
In Operating Systems 

The recently-released MS-DOS 5.0 
has standard support for code page 852 
(Eastern Europe), which they’re now 
calling “Latin 2" or “Slavic" (the latter is 
slightly misleading, since 852 can be 
used for Romanian). Additionally, there 
are new functions for code mapping 
but they’re still one-to-one. 

A superficial glance at the even 
newer DR-DOS 6.0 gives me the impres¬ 
sion they support not only code page 
852 but also 857 “Turkish.” 

Where To Next? 

I have two suggestions to Microsoft. 
First, thanks for the code-page-852 sup¬ 
port, but can we have code pages for 
the remaining European languages that 
can't be handled with the current sets 
(Latvian, Lithuanian and Turkish)? 
Second, the documentation for code 
page collation tables should be revised 
to include some strong warnings about 
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Listing 2 — Cont’d 





int get language () 

{ 

int i ; 


NEW TOOL 


MAKES 

for {;;) { 

printf(“Alphabets\n"); 


WINDOWS APPS 

printf (" .\n"); 

printf("(0) French\n"); 
printf(“(1) Danish\n"); 


RUN FASTER. 

printf(“(3) Polish\n“); 
printf (" (4) Spanish\n“); 

printf("Enter a number corresponding to one of the above alphabets:"); 


WindEXE optimizes Windows 

scanf(”%d",&i); 

if (i>=0 && i<=4) return (i); } } 


applications for maximum 
runtime speed and efficiency; 

int getline (FILE *fp,char *a,const unsigned int b) 

( 


without changing source code! 

unsigned int i; 
int c; 


WindEXE improves Windows 

for (i=0;; ++i) { 


3.0 applications with two steps: 

c=getc(fp); 


First, WindEXE minimizes the 

if (c==E0F) return (-1); 
if (c== 1 \n ') break; 


number of calls which are made 

if (i<b) *(a++)=c; ) 

*a= * \0 * ; 
return (0); } 

void translate (char *s,char *t,unsigned int language,const unsigned int b) 

{ 

unsigned int i; 


from one segment to another, to 
reduce delays caused by disk 
swapping. Next, WindEXE makes 
all the segments uniform in size, 
to speed up swapping when it 
does occur. 

for (i=0; i<b-l;++i) { 



if ( (*t=code_set[(unsigned char) *(s++)])== l \0‘) break; 
if (i>0) { 


WindEXE is FAST and 

switch (language) ( /* digraph tests */ 


SIMPLE. No tedious procedures 

case SPANISH: 

if (*t==L && *(t-l)==L ) *(t-l)=l+L ; /* LL? */ 


are involved. You simply: 

else if (*t==H && *(t-l)==C ) *(t-l)=l+C ; /* CH? */ 



else ++t; 
break; 

case GERMAN: 

if ((unsigned char) *(s-l)==225) *(t-l)=*(t++)=S ; /* eszet? */ 

++t; 

break; 

default: 


• compile and link for 
debugging 

• run WindEXE 

• compare to see the 


improvements 

++t; 



break; } ) 
else ++t; ) 

*t= 1 \0 ' ; ) 


Order your copy of WindEXE 
today for $350, with a 30 day 

money back guarantee. 

int comp function (const void *a,const void *b) 

{ 

return (strcmp(a.b)); ) 


Call or fax today for a complete 
technical description. 

void putline (FILE *fp,char *s) 

( 

int c; 


phone: 614-798-1091 ext. 301 
fax: 614-798-1099 

for (;;) { 



c=*(s++) ; 
if (c== ' \0 1 ) { 


1C Technologies Corporation 

putcCXn'.fp); 


break; ) 


Building E 

putc(c.fp); } } 


6400 Riverside Drive 

/* End of File */ 


Dublin, OH 43017 



WindEXE™ is a trademark of 1C Technologies Corp. 
Windows™ is a trademark of Microsoft Corp. 
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the sorts of quirks and surprises 
described above. The documentation is 
totally wrong to suggest, as it does, 
that mapping with collation tables con¬ 
stitutes “national language support.” 

OS/2 uses the same code page sys¬ 
tem as in MS-DOS, so the same caveats 
apply. Windows 3.0 uses a new default 
character set called “ANSI"; a listing can 
be found in the Microsoft Windows 


Software Development Kit (Reference: 
Volume 2, page D-2). Like code page 
850, the new character set has all the 
characters one could want for Western 
Europe and Scandinavia - but the order 
is completely changed. Someday some¬ 
one may explain this. Meanwhile, con¬ 
sider using the non-default “OEM font” 
for the IBM PC Extended Character Set, 
good old code page 437. The routine 


GetKBCodePage is available in the 
Software Development Kit. 

Clearly, there are still frustrating 
problems, but things are getting better. 
New equipment has better capabilities 
for displaying and printing varietal char¬ 
acters. Increasing knowledge of the 
various character standards is leading to 
better support 

The excuses of the past are no 
longer acceptable. Today's tools and 
standards are not very good, but this 
article shows that they can be used. 
Every serious software vendor should 
be including cross-language support, or 
promising it for real soon now. 

Eventually, language support should 
extend to yet more languages, including 
ones with non-Roman alphabets like 
Cyrillic and Greek, and Roman-based, 
non-European languages like Swahili or 
Vietnamese. (There's already a proposal 
for a 16-bit code - Microsoft is among 
its proponents.) I’d be grateful to 
anyone who can let me know what's 
going on with such proposals, or to 
anyone who can set me straight on 
possible omissions or errors anywhere 
in this article. □ 


Listing 3 

/* The parameter in the following procedure is S, which is the string 
we want to translate. We return the translated characters in S. */ 
translation (S,main_table,sequential_table) 
unsigned char S[]; /* NB: it won't be unsigned by default */ 

char main_table[]; /* the main 256-byte collation-lookup table */ 

char sequential tablet]; /* list of 2-byte character codes (if any) */ 

{ 

unsigned int i,j,collation_code; 

for (i=0; S[i]!='\0'; ++i) { 
col 1ation_code=main_table[S[1]]; 
for (j=0; sequential_table[j]!= 1 \0'; j+=3) { 
if (S[i]==sequential_table[j] && S[i+l]==sequential_table[j_l]) { 
S[i]=sequential_table[j+2]; 
break; } ) 

/* Note: if language is German, put a line here for 

translating the eszet (usually code 225) to SS. Note that 
results in a size increase. */ 

S[i]=collation_code; } } 

/* End of File */ 


C++/Views 

for Microsoft Windows 


C++/Views is a development tool for C++ programmers 
' tljat not only redydbs the complexity of Microsoft 
Window s 3.0 but also slashes development time 
by upto\75%. 

Delivers on the promise of Object-Oriented x 
Programming (OOP). 

Encapsulates more’MS Windows 3.Q functionality than ant- 
other tool on the market'today. ‘Get MS JJjndbWs c 
applications off to a. fast stah with a framework of 
over “’5 tested and ready-to-go C++ classes. 

Has the most complete C++ class library for MS 
Windows Development. x * \m 

" GGtklstarted With graphical user interface classes ^uch as 
( dl tfinclow's, views.'bitmaps. dialog boxes, menus!'popup 
menus, graphics', regions, pens. Lmishes. controls.buttons, 
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streams-and so-on. Use.-,other dassekto manage tne 
persistanOje c" 
communicaJ. ^ 


Provides support for the entire project. 

Comes with afcomplete OOP development environment 
including the first fully functional C++ class hierarchy 
Browser. Also includes an Interface Generator • for building 
C++ dialog classes and a Documentor for automatically 
producing high quality documentation of your classes. \ 

Integrates leading-edge technology>. 

Combine C++ View s r with Borland C++ or Zortech C++ 
for a .cost-effective and highly productive development 
environment for building your next generation software 
systems, k Uflt 

Pays for itself on even the smallest project. 

Only $ 495.00 with no royalties."' -. 1 
Comes complete withgource cpue ' • v , 


C++/Views 

from CNS, 


Si 


ijects,adpss 'files, to perform serial 

anclto activate timed events. x TT * 

CNS, Inc.. Software Products Dept. 

1250 Park Road, Chanhassen, MN 55317, (612.-474-7600 • FAX f6t2)-474-6737. 
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Internationalization 


Japanese Double Byte 
Character Processing 

John G. Nelson 



Modern written Japanese consists of more than 6,000 unique characters, compris¬ 
ing two native alphabets (katakana and hiragana), plus Chinese characters (kanji), 
English characters, and Arabic numerals, as well as a full set of general and punctua¬ 
tion symbols. Since the seven-bit ASCII byte provides a mere 128 unique patterns, 
Japanese engineers faced the problem of designing a character set that was large 
enough to support the larger number of Japanese glyphs yet still maintained com¬ 
patibility with the internationally accepted ASCII standard. 

The first generation of Japanese microcomputers avoided the problem by simply 
adhering to the ASCII standard and not attempting to represent the Japanese lan¬ 
guage, thereby forcing Japanese users to use English for computer I/O. Only with the 
arrival of faster microprocessors and improvements in primary/secondary storage 
techniques was Japanese realized on the Japanese PCs. 

To accommodate the fact that a Japanese character set had to be much larger 
than ASCII and to maintain alignment, a unit of storage was adopted with exactly two 
bytes (16 bits). The coined double-byte character (DBC) increased the number of uni¬ 
que codes to 65K, more than enough to handle all of Japanese codes and still allow 

plenty of room for growth. To maintain com¬ 
patibility, a technique was needed to allow ASCII 
single-byte characters to be represented alongside 
the Japanese DBCs. The first standard, the Japanese 
Industry Standard (JIS), defined over 6,000 total 
characters. Due to overlap between ASCII and DBC 
codes, a DBC on/off escape sequence was built in 
to allow the two standards to coexist 


John G. Nelson holds a B.S. in computer science from Colorado State 
University. He has been with Pacific Software Publishing for two years 
as the primary Japanese localization specialist. Pacific Software 
Publishing provides Japanese localization, translation, education and 
consulting services at all levels. In his spare time, John works as a 
class V Whitewater rafting guide, ski instructor, and alpine climbing 
guide. He can be reached at PSP, Inc., 2737 77th Ave. S.E., Mercer 
Island, WA 98040. (206) 232-3989. 
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Listing 1 


♦define TRUE 1 
♦define FALSE 2 

typedef unsigned char BOOL; 
typedef unsigned char DBC; 

♦include <dos.h> 

♦define MAXRANGES 10 

♦define GETDBCRANGES 0x6300 
♦define KANJ1FLAG 0 

♦define NUMKRANGES 1 

♦define STARTRANGES 2 

♦define VIDEO 0x10 

♦define GETSCREENMODE OxOf 

♦define GETSCRNMODE 0x50 /* Screen country code */ 

♦define SETSCREENMODE 0x00 /* Screen mode */ 

♦define AXJGRAPHICS 0x53 


♦define AXJTEXT 0x03 

♦define KEYBOARD 0x16 

♦define CHECKKB Oxll 

♦define GETKEY 0x10 

♦define JAPAN 0x51 


/* Kanji System Information Array 
* 

* iKanjilnfo[0] -> BOOL indicating kanji system or not. 

* [1] -> iNumRanges Number of Kanji code ranges. 

* [2] -> Range fl's low value for lead byte of DBC. 

* [3] -> Range #1's high value for lead byte of DBC. 


* [iNumRanges*2] -> Range An's low value for lead byte of DBC. 

* [iNumRanges*2+l] -> Range ♦n's high value for lead byte of DBC. 
*/ 

int far piKanjiInfo[(MAXRANGES*2)+2]; 

BOOL blnitKanji (void); 

BOOL blsDBC (DBC *); 


/*** blsDBC - Determines if character is a DBC. 


* written by: John G. Nelson, Pacific Software Publishing Inc. 

* copyright: Pacific Software Publishing Inc. 

* date: 4/91 

* description:Determines if a DBC pointer is pointing to a DBC. 

* inputs: Pointer to a DBC or a SBC. 

* outputs: TRUE if the pointer points to a DBC. 

* FALSE otherwise. 


BOOL blsDBC( 

DBC *pdbcChar) /* pointer to DBC */ 

( 

int i; 
int iValue; 

static BOOL bNotlnit = TRUE; 
if (bNotlnit) ( 

bNotlnit = FALSE; 
if (FALSE == blnitKanji()) ( 

return(FALSE); 

) 

) 

iValue = pdbcChar[0]; 
i - STARTRANGES; 

/* Is kanji system installed */ 

if (0 ** *piKanjiInfo) ( 
return(FALSE); 

) 


while (TRUE) ( 

if (piKanjiInfo[NUMKRANGES] — (i-2)/2) ( 

return(FALSE); 

) 

if ((piKanjiInfo[i] <= iValue) && (piKanjiInfo[i+l] >= iValue)) { 
return(TRUE); 

) 

i +- 2; 

) 

) /* blsDBC / 


Microsoft determined that DOS could 
not be gracefully ported to the JIS char¬ 
acter set, so a new standard based on 
JIS but friendlier to a DOS port was 
spawned. This new standard, called 
Shift-JIS, had the benefit of separating 
the DBC 1st byte ranges and ASCII char¬ 
acters to different code space (see Fig¬ 
ure 1), eliminating the need for the DBC 
shift in/out mechanism (the “Shift" in 
Shift-JIS denotes that the JIS code space 
has been shifted). 

As Japanese DOS became the operat¬ 
ing system of choice on Japanese 
microcomputers, Shift-JIS's popularity 
also grew. While printers and a limited 
set of other devices continue to support 
JIS, most Japanese PC hardware now 
supports Shift-JIS internally. Several 
other double-byte character sets, 
products of Japanese mainframes, might 
occasionally be encountered on 
Japanese PCs. They are EUC (UNIX stand¬ 
ard), IBM kanji, NEC (NEC standard, al¬ 
though the NEC 9801 PC uses JIS and 
Shift-JIS), and the DEC kanji. However, 
unless a PC application is communicat¬ 
ing with or is being ported to a 
Japanese mainframe, support of JIS and 
Shift-JIS is adequate. This article addres¬ 
ses only the Shift-JIS standard. 

For simplicity, the example programs 
were implemented on an AX (Architec¬ 
ture Extended) machine with Japanese 
DOS v.3.21j. The AX is completely com¬ 
patible with the IBM PC AT, though it 
has been extended to support the 
Japanese language. The AX operates in 
two modes, English and Japanese. In 
English mode the machine functions ex¬ 
actly as an AT and the Japanese exten¬ 
sions are disabled. With the exception 
of the AX PC, almost all Japanese PC 
hardware deviates significantly from the 
IBM PC. 

The usual migration path for English 
PC software to Japan involves enabling 
an application to handle DBCs (DBC 
enablement). Normally this is done on 
an AX, since this allows hardware de¬ 
pendencies to be separated from the 
DBC handling. Once the added Japanese 
features have been fully tested on the 
AX machine, ports to other Japanese 
PCs can then be approached with con¬ 
fidence. 

It should be noted that although DOS 
is the standard operating system of all 
the Japanese PCs, it is not completely 
standardized. This is because DOS was 
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Listing 1 — Cont’d 


/* blnitKanjl 


* written by: 

* copyright: 

* date: 

* description: 

* functions: 

* 

* inputs: 

* outputs: 

* 

* globals mod: 
*/ 

BOOL blnitKanji( 
void) 

( 


John G. Nelson, Pacific Software Publishing Inc. 
Pacific Software Publishing Inc. 

9/91 

Checks if AX Kanji system or not. 

Calls DOS subfunction 0x63 to retrieve 

kanji lead byte ranges. 

none 

FALSE - The Kanji system is not being used. 

TRUE that Kanji system is available and initialized. 
iKanjilnfo character array. 


union REGS regReg; 

struct SREGS sregSreg; 

unsigned char far *fpRanges; 
int iNumRanges * 0; 

int i; 

char cOrigMode; 


/* Get original screen mode */ 

regReg.h.ah = GETSCREENMODE; 
int86 (VIDEO, AregReg, &regReg); 
cOrigMode = regReg.h.al; 


/* Determine if AX system */ 

/* by attempting to set screen mode to AXJGRAPHICS */ 
regReg.h.ah = SETSCREENMODE: 
regReg.h.al * AXJGRAPHICS; 
int86 (VIDEO, SregReg, SregReg); 

/* Check if set mode was successful */ 

regReg.h.ah = GETSCREENMODE: 
regReg.h.al « 0; 

int86 (VIDEO, AregReg, SregReg); 
if (AXJGRAPHICS — regReg.h.al) { 

/* AX system proved */ 

/* Set screen mode back to original before test*/ 

regReg.h.ah - SETSCREENMODE; 

regReg.h.al ■ cOrigMode; 

int86 (VIDEO, &regReg, SregReg); 


/* Get Mode of AX Screen */ 

regReg.h.ah = GETSCRNMODE; 
regReg.h.al « 1; 

int86 (VIDEO, &regReg, &regReg); 
if (JAPAN != regReg.x.bx) ( 
return(FALSE); 

} 


) else ( 

/* Set screen mode to original before AX test */ 

regReg.h.ah = SETSCREENMODE; 

regReg.h.al = cOrigMode; 

int86 (VIDEO, AregReg, &regReg); 

piKanjiInfo[KANJIFLAG] ■ FALSE; 

return(FALSE); 

) 

pi KanjiInfo[KANJI FLAG] ■ TRUE; 


/* Gets address of DBC ranges */ 

regReg.x.ax ■ GETDBCRANGES; 

intdosx (SregReg, SregReg, SsregSreg); 

fpRanges = MK_FP (sregSreg.ds, regReg.x.si); 
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Listing 1 — Cont’d 

/* Copy ranges to cKanjilnfo array */ 

1 = STARTRANGES; 
while (TRUE) { 

if (0 == (piKanjiInfo[i++] = *fpRanges++)) { 
break; 

) 

if (0 == i%2) ( 

iNumRanges++; 

} 

if (MAXRANGES == iNumRanges) { 
return(FALSE); 

) 

} 

piKanjiInfo[NUMKRANGES] = iNumRanges; 
if (0 ** iNumRanges) { 

/* Default Ranges *1 

i = STARTRANGES; 

piKanjiInfo[NUMKRANGES] = 2; 

piKanjiInfo[i++] ■ 0x81; 

piKanjiInfo[i++] * 0x9f; 

piKanjiInfo[i++] - OxeO; 

piKanji!nfo[i++] = Oxfc; 


return (piKanjilnfofKANJIFLAG]); 
) /* blnitKanji */ 

/* End of File */ 


localized separately by each of the 
Japanese PC makers. Therefore, sig¬ 
nificant differences are sometimes 
found among the various Japanese DOS 
versions. 

This article covers the basics of DBC 
enablement and highlights some poten¬ 
tial problem areas which will need at¬ 
tention in an English to Japanese 
localization effort 

The DBC Entity 

To effectively handle the Shift-JIS 
character set, it's necessary to discard 
the idea that a character always has a 
uniform size. Japanese character sets 
support both one- and two-byte char¬ 
acters, and the double-byte characters 
should always be recognized and 
treated as single distinct entities. A DBC 
should never be divided or processed as 
two separate halves of a character be¬ 
cause one byte of a DBC is meaningless 
by itself. It makes no more sense to as¬ 
sume that the first byte of a DBC cor¬ 
responds to the left half of a kanji 
graphic than it does to assume that 4H 
in the ASCII representation of A (41H) 
represents half of an A. 

Some “English” program code frag¬ 
ments which deal with character 
processing may still work even when 
thrown into the DBC world. For ex¬ 
ample, a routine which inserts a single¬ 
byte character into a string can handle 
DBCs by multiple insert operations for 
the successive bytes of a DBC. However, 
Japanese programmers expect DBCs to 
be treated as whole entities. In the in¬ 
terest of readability, maintainability, and 
portability, DBCs should not be treated 
as successive bytes in a stream. Unex¬ 
pected results occur when character 
handling routines are not specifically 
modified to handle DBCs as distinct 
units. In the insert example, everything 
works fine except for the case when a 
double-byte character is inserted in a 
string that has room for only one byte. 
In this case the first byte insertion 
would succeed while the second byte 
insertion would fail, leaving the pro¬ 
gram with a meaningless half of a kanji. 

Detecting A DBC 

A DBC can be detected by checking 
to see if the value of the first byte falls 
into the Shift-JIS first byte ranges 81H- 
9fH or eOH-fcH. 
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The following C typedef for a DBC 
will be used for all subsequent code ex¬ 
amples: 

typedef unsigned char DBC; 

BOOL bIsDBC( DBC *pdbcA ) { 
if (( 81H <M=> pdbcA[0] ) 

&&( 9fH=pdbcA[0] )) 
return TRUE; 
if (( eOH<B>A[0] )&&( 
fcH=pdbcA[0] )) 

return TRUE; 
return FALSE; 

} 

The problem with this routine is that 
the DBC first-byte ranges are hard¬ 
coded within it. This limits the applica¬ 
tions to Japanese double-byte character 
sets. Since Korea, Taiwan, and China 
also have DBC sets, a better approach 
would be to have the routine request 
the ranges from the system. DBC DOS 
versions provide a BIOS function which 
will returns the ranges of the DBC first 
byte. By calling this routine, an applica¬ 
tion will be current with extensions or 
modifications to the Shift-JIS DBC ranges 
while preparing for ports to other DBC 
countries. A better blsDBC function, 
modified to make use of the DOS's DBC 
range requesting function, is shown in 
Listing 1. blsDBC is a fundamental 
routine used extensively in Japanese 
applications. The subsequent examples 
will use blsDBC as well. 

Internal DBC Representation 

It may first appear that the cleanest 
solution to the problem of editing DBC 
strings would be to adopt a full double¬ 
byte scheme internally, that is, to allo¬ 
cate two bytes for all characters, SBCs 
and DBCs alike. Editing issues such as 
cursor movement, deletion, insertion 
and replacement could be handled with 
the following preprocessor directive 

Idefine char int 

Such an approach may solve the imme¬ 
diate tasks of text editing but it intro¬ 
duces many new problems that are 
hard to resolve. For instance, since 
standard library output functions cannot 
directly handle the new character type, 
strings would have to be converted to 
the standard Shift-JIS representation 
before invoking string I/O functions. This 


introduces a standard overhead for 
standard string I/O functions (e.g., 
printf). Except in the case of an ap¬ 
plication especially tuned to full DBC 
representation model, this approach in¬ 
troduces more complexity than it resol¬ 
ves. 

The practice of using a variable char¬ 
acter size is referred to as the mixed 
character scheme. The mixed character 
scheme is the standard technique 
adopted in Japanese applications and is 
presumed by all of the example 
programs presented here. 


DBC Editing 

The presence of both single- and 
double-byte characters in Japanese text 
complicates such basic editing tasks as 
cursor movement, deletion, insertion, 
replacement, and searching. To process 
Japanese text correctly some basic rules 
should be followed. 

First, never position the cursor on 
the second (trailing) byte of a DBC The 
2nd byte of a DBC is often referred to 
as an illegal byte. Ensuring that the cur¬ 
sor is always positioned on either the first 
(lead) byte of a DBC or on a single-byte 
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int f(n) 
int n; 
f 

int result; 

ifC n == 1 ) result = 0; 
else if( n > 0 ) result = 1; 
else ifC n < 0 ) result = 2; 
return result; 

) 


This function has a slight flaw. Can you spot it? 
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Listing 2 


linclude <string.h> 


/*“ iDBCCharRplc - Replaces a character in a string. 


* written by: John G. Nelson, Pacific Software Publishing Inc. 

* copyright: Pacific Software Publishing Inc. 

* date: 10/91 

* purpose: Allows a single (DBC or sbc) character in a DBC 

* string to be replaced by another (DBC or sbc) character. 

* The replacement only takes place if there is 

* sufficient room in the string. 

* parameters: pdbcString : Pointer to DBC string. 

* iOffset : Byte position of character to be replaced. 

* pdbcChar : Incoming character. 

* iMaxLen : Length of pdbcField in bytes. 

* return: iOffset : Replacement does not have enough room. 

* iNewOffset : Offset indicating position of character 

* imnediately following newly replaced character. 

*/ 

int iDBCRplcChar( 

DBC ‘pdbcString,/* DBC string */ 
int iOffset, /* Offset */ 

DBC ‘pdbcChar, /* DBC */ 

int iMaxLen) /* Max bytes */ 

{ 


int ilnChSz, iOutChSz; 
int iRoom; /* bytes slots */ 
int iStrLen; 
int i; 


iStrLen = strlen(pdbcString); 

iRoom = iMaxLen - iStrLen; 

ilnChSz = (blsDBC(pdbcChar)) ? 2 : 1; 

iOutChSz = (bIsDBC(&pdbcString[iOffset])) ? 2 : 1; 

/* check if there is enough room for replacement*/ 
if ((ilnChSz - iOutChSz) > iRoom) { 

/* not room to accomodate replacement */ 

return(iOffset); 


/* enough room for replacement */ 

if (-1 == (ilnChSz - iOutChSz)) { 

/* DBC by SBC replacement case */ 

/* shift left to delete 2nd byte of OutDBC */ 
memmove(&pdbcString[iOffset+l], 
&pdbcString[i0ffset+2], 
iStrLen-iOffset); 

) else if (1 == (iInChSz-iOutChSz)) ( 

/* SBC by DBC replacement case */ 

/* shift right to make room for 2nd byte */ 
memmove(&pdbcString[i0ffset+2], 
&pdbcString[iOffset+l], 
iStrLen-iOffset); 


/* replace character */ 

for (i=0; i<iInChSz; i++) { 

pdbcString[iOffset+i] = pdbcChar[i]; 

) 

return (iOffset+iInChSz); 

} /* iDBCCharRplc */ 

/* End of File */ 


character helps to avoid problems. 
When deleting a DBC, always delete 
both bytes at one time: never leave 
half of a DBC character in a string. 
Remember that inserting a DBC requires 
room for two bytes and insertion of 
two bytes and that replacement must 
account for size differences between 
the incoming and outgoing character. 
Substring search must also deal with 
special problems introduced with DBCs. 

Cursor movement should be ad¬ 
dressed first Moving right in a string is 
simple: if positioned on a DBC move 
right by two bytes; otherwise, move 
right by one byte. Moving left is not so 
simple, because the range of the 
second byte of a DBC overlaps the ran¬ 
ges both of the standard ASCII chart and 
the first byte of the DBC. This means 
that the byte immediately to the left of 
the current byte position in a string 
cannot be readily identified either as an 
SBC or as the second byte of a DBC (Fig¬ 
ure 2). To move left in a string, you 
must begin counting at the beginning of 
the string and step through the string 
to the right until the byte in question is 
reached. At that time you see whether 
the byte is a single-byte character or 
the second byte of a DBC. If the byte is 
the second byte of a DBC, move left by 
two bytes; otherwise, move left by one 
byte. 

The process of deleting a character 
involves checking for a DBC and deleting 
two bytes instead of one. 

An insertion function now must 
check if it is to insert an SBC or a DBC. If 
the latter is true, the string must be 
shifted by two bytes and two bytes 
must be copied. It is important to note 
that to successfully insert a DBC into a 
string, the size of the preinserted string 
cannot be more than MAXSIZE-2 bytes, 
where MAXSIZE is the total number of 
bytes allowed for the string. 

The function for replacing a charac¬ 
ter changes as well. The following is a 
standard replacement function in a 
single-byte character system: 

void vRplcChar( 

char cChar, /* InChar */ 

int iOffset, /* Offset */ 

char ‘pcString /* String */) 

{ 

pcString [iOffset] = cChar; 

} 
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The replacement function warrants a 
separate routine because with DBC sys¬ 
tems, the logic is more complicated (see 
Listing 2). A precondition of this function 
is that pdbcString[iOffset] references 
either the first byte of a DBC or an SBC 
and pdbcChar is the pointer to a 
double-byte character or is the pointer 
to a single-byte character. The routine 
returns the offset of the character after 
the replaced character or the original 
offset if the replacement failed . 

In an SBC system, replacement is a 
no-fail operation: all possible combina¬ 
tions of incoming characters and outgo¬ 
ing characters end in a successful re¬ 
placement. In DBC systems, however, 
replacement does have a failure case: if 
(a) the string is full, (b) the incoming 
character is a DBC, and (c) the outgoing 
character is an SBC, then the replace¬ 
ment will fail. This is because there is 
no extra byte in the string that allows 
for the one-byte size difference be¬ 
tween the incoming DBC and the outgo¬ 
ing SBC. 

Routines that search a string for a 
substring must be DBC aware. Tradition¬ 
ally, it was adequate to step through 
the text string byte by byte, checking 
for the substring at each byte position. 
That algorithm will not work in the 
double-byte system because legal DBC 
strings may hide other syntactically cor¬ 
rect substrings which are not legal (Fig¬ 
ure 3). A legal substring begins with the 
first byte of a DBC or an SBC and must 
end with an SBC or the second byte of 
a DBC. To avoid the problem the search 
routine must step through the searched 
text one character at a time rather than 
one byte at a time. 

Screen Considerations 

Displaying a DBC requires exactly 
twice the display width of an SBC. This 
is a nice convention because it means 
the display width of a DBC string in the 
mixed character scheme is the same as 
the byte width. 

In dealing with DBCs and the screen, 
it is particularly important to recognize 
that a DBC is a single distinct unit Be¬ 
cause Japanese video controllers 
generally operate on this premise, stray 
bytes from divided or misaligned DBCs 
may partially or completely corrupt the 
interpretation of video memory by the 
video controller. 


The video controller expects each 
screen line to begin with an SBC or the 
first byte of a DBC. If a screen line 
begins with the second byte of a DBC, 
the results will be unpredictable. In the 
same vein, a screen line should not be 
terminated with the first byte of a DBC. 

The Japanese text cursor behaves 
differently on Japanese PCs. Just as the 
width of displayed characters varies be¬ 
tween one- and two-character cells, so 
does the width of the text cursor. Basi¬ 
cally, the cursor takes the width of the 
character on which it is positioned - 
two cells for a DBC, one for an SBC. Nor¬ 
mally, if the cursor is placed on the 
second byte of a DBC, the cursor will 
simply disappear, and it will remain hid¬ 
den until the cursor is moved or the 


byte under the cursor is updated to be 
an SBC or the first byte of a DBC. It is 
the application's responsibility to ensure 
that the cursor is not placed on an il¬ 
legal byte. 

Another key issue with the Japanese 
screen involves text mode windowing. 
When a region of the screen is cleared, 
care must be taken to clear/save/re¬ 
store half DBCs from VRAM. The two 
cases that must be checked for are 
when the left edge of cleared region 
falls on the second byte of a DBC or the 
right edge falls on the first byte of a 
DBC. Either of these cases will leave 
half-DBC bytes in VRAM after the clear 
region function has finished. A DBC- 
enabled clear region routine must 
check for the special divided DBC cases 
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Japanese And Windows 3.0 

Leslie Gardenswartz 


Unlike DOS, Windows 3.0 takes care of most 
Japanese hardware compatibility issues for you, leaving 
you with only your application to worry about If you 
follow the Windows programming guidelines and store 
your user interface (strings, dialog boxes, menus, and 
so on) as resources, translating the user interface to 
Japanese should be straightforward. 

You will also want to study the documentation on 
the [INTL] section in UIN.INI. This is the Windows 
way of storing the extended country information that 
DOS maintains. Here you will find settings such as time 
and date format, list separators, currency formats, and 
so on. Windows makes it easy (much easier than DOS) for 
the user to switch languages and tailor country settings. 

The Windows kernel is essentially the same for all 
languages-, it is the language-specific DLLs that handle 
the different countries. You can use the Windows con¬ 
trol panel to test your application with another 
country's keyboard and character set. However, for 
Japanese applications you really need to get the full 
implementation of Japanese Windows. A version of 
Japanese Windows that can run on an ordinary PC-AT 
should be in beta testing by the time you read this. 
You will also need at least UINNLS.LIB and IME.H from 
the Japanese SDK. As of this writing, though, the 
Japanese SDK has not been translated to English. 

The Japanese menus are a little different from the 
English menus. The English menu typically underlines 
the letter in a menu item that corresponds to an ac¬ 
celerator key. For example, in the “File” menu item, the 
“F” is underlined. Japanese menus, however, display the 
menu item in Japanese and then, in parentheses, the 
underlined accelerator key. For example, the 
equivalent of the "File" menu item is: 

7 7 'NM E ) 

As with any other language, you should make sure 
your Japanese application uses AnsiUpperf), Ansi- 
Lower(), IsCharAlphaf), IsCharAlphaNumeric(), Is- 
CharUpper(), and IsCharLower() in the appropriate 
places. You should also use IstrcmpO and Istrcmpi () 
for string comparisons to obtain correct results for the 
current language. The sorting routines are not perfect For 
example, they treat a double-byte “A" differently than a 
single-byte “A," so you may have to write your own com¬ 
parison functions to correctly handle the double-byte ver¬ 
sion of Roman characters correctly. 


Many Windows programs do not bother to use 
AnsiNextf) and AnsiPrev() to move within a charac¬ 
ter string. With the Japanese double-byte character set, 
those functions are critical. You still have to write your 
own functions to handle deleting and inserting charac¬ 
ters in a double-byte character set string. 

Just as Japanese DOS has a Front End Processor to 
allow users to enter kanji text, Japanese Windows has 
the Input Method Editor (IME). The IME is a separate 
window that performs all the same functions as the 
Front End Processor. In fact, you do not have to modify 
your Windows program to use the IME. 

To the application, the IME is a separate, 
transparent window controlled by Windows. As in DOS, 
the user starts the IME from the keyboard. After start¬ 
ing the IME, the user enters characters and uses the 
IME to translate the characters into the appropriate 
kanji. When the user presses the ENTER key, the IME 
sends the correct characters to your application with 
the standard UM_CHAR message. Just as with DOS, you 
will get two characters ( UM_CHAR messages in Win¬ 
dows) for each kanji. It is up to your application to 
treat the characters as a logical unit 

Just before the IME begins sending characters, your 
application will get a UM_IME_REP0RT message. The w- 
Param for the message will be equal to 
IR_STRINGSTART. After all the characters have been 
sent, the application will get another UM_IME_REPORT 
message with the wParam equal to IR_STRINGEND. To 
the user, all the characters between these two mes¬ 
sages were entered as a unit, so your application 
should treat them that way. For example, if the incom¬ 
ing characters exceed a fixed-length data field, your 
application should not beep on each UM_CHAR message 
in an IME stream. Instead, it should beep once and 
then ignore UM_CHAR messages until the trailing 
UM_IME_REPORT message ( wParam equal to IR_STRIN- 
GEND). 

In short, most Windows applications that are DBC- 
aware should have very little trouble running under 
the Japanese version of Windows. Notice the word 
"should” - little things always crop up, but the graphi¬ 
cal nature of Windows and Windows' font handling 
makes the conversion a little less painful. Don’t worry, 
though, you will still get the unavoidable UAE now and 
then, but at least it will be in Japanese! □ 


Leslie Gardenswartz is an independent software contractor developing Windows applications. You can contact 
him at 15733 25th Avenue SW, Seattle, WA 98(66 or at (206) 241-7149. 


Page 30 — Windows/DOS Developer’s Journal 


January 1992 





and clear half-DBC bytes as necessary. Some text-windowed 
applications will place a special character to indicate that a 
half-byte was cleared by the windowing process. 

Because Shift-JIS DBC first byte code space uses many of 
the codes in the upper half of the extended ASCII chart and 
because single-byte Japanese katakana characters take the 
remaining codes in the area, most of the extended ASCII char¬ 
acters are no longer available on Japanese PCs. On the AX, line 
drawing characters for single-lined and double-lined boxes and 
a few selected selected graphic characters have been 
remapped to the ASCII control code range 01H - lfH. If an 
American application relies heavily on the graphics defined in 
the extended ASCII character set, it can make use of the codes 
which have been remapped, redefine the remapped charac¬ 
ters as necessary, or register its own special Shift-JIS DBCs 
(gaiji). The point is that the problem of lost line/graphic charac¬ 
ters can be easily resolved. 

Keyboard Considerations 

Since the Shift-JIS specification defines over 6K unique char¬ 
acters, a keyboard would have to be rather large to have a 
unique keytop for each character. Experiments with a large, 
curving prototype that resembled an old church organ with 
rows and rows of keys quickly showed that even simple user 
input created a serious search problem. 

The next step for Japanese kanji input was the kuten code, 
which required the user to find the kanji code in a book and 
then type the code on the keyboard. This process was slow, 
error prone, laborious, and not at all friendly to the user. 

With the emergence of the front end processors (FEPs), a 
more direct and efficient method for entering keyed kanji 
input was developed. FEPs allow the user to enter sequences 
of alphabetic or phonetic characters which can then be 
modified and translated multiple ways to find the correct DBC 
combination. 

FEPs can operate transparently to an application (as they 
do in most cases), or they can be partially or fully controlled 
from within an application. A user can toggle the FEP on and 
off by using a special key or key combination on the key¬ 
board. 

Under transparent FEP operation the only indication that an 
FEP is installed is the presence of DBCs in the input stream. 
The FEP hooks into the hardware-generated keyboard inter¬ 
rupt and captures key and scan codes as they enter the sys¬ 
tem. It does not immediately pass the character to the BIOSs 
keyboard input buffer for retrieval by an application but in¬ 
stead buffers the characters internally for possible translations 
by the user. The buffered characters are displayed to the user 
on the screen along with a menu of possible conversion and 
translation functions. For the display of these items, the FEP 
reserves the 25th screen line and uses it for its own purposes. 
When the user accepts the translated Japanese string via a 
function key, the DBC string is placed in the keyboard buffer, 
where the application is able to access it 

When the FEP is turned off, the keyboard is available for 
entering single-byte English or single-byte Japanese characters 
(katakana), depending on the status of the kana shift key. 

Problems arise if an application is dependent on the trap¬ 
ping of a keyboard hardware interrupt. This may be resolved 
by passing the keys on to the FEP after the application's inter¬ 


rupt routine has finished. If that proves to be too slow for 
performance purposes, then the application will either have to 
be unhooked from the interrupt or the FEP will have to be 
controlled by the application. 

Because transparent FEPs traditionally use the 25th line for 
menu and intermediate translation display, it is good DBC 
programming practice to leave the 25th line blank. Another 
interesting activity invoked by the FEP is based on the position 
of the text cursor. If the text cursor is positioned on the 25th 
line when the FEP is turned on, the entire screen is scrolled up 
by one line in an effort to the keep the text cursor on the 
display. Unwary applications with pretty Uls can be quickly 
corrupted. Further, when the FEP is turned off, it does not 
scroll the screen back down. This behavior reinforces the argu¬ 
ment for giving the FEP sole use of the 25th screen line. 

When an application retrieves a key using the BIOS getkey 
interrupt, it must check if the byte bIsDBC(&pByte). If DBC first 
byte is found, then the second byte of the DBC must be 
retrieved from the keyboard buffer (see Listing 3). This is 
where treating the DBC as an entity begins. When a DBC is 
placed in the buffer by the FEP, the second byte follows the 
first. The FEP will never place a half-DBC byte into the key¬ 
board buffer. If this were somehow to happen, the error 
would go undetected by the application. If an SBC is found in 
the keyboard buffer, it can be processed as usual. 

Function keys are entered in the input stream in the nor¬ 
mal way, but they can't be entered when the FEP is invoked. 
The user must turn off the FEP to enter special keys. This is a 
problem for the user, however, and not the application. 


Hypertext source code analysis / editing. 



{Find, analyze, organize, edit 
Functions: 

Typedefs; 

Structures; 

Variables; 

Globals; 

with a sinale 


Call or Write; 


Tri-Tcennology spnnt, Ir 
1000 Jorio BN., Suite 5 
Oak Brook, II. 60521 
Phono (70*| 972-1277 
BBS/Fox (708) 972-1299 


□ Request 329 on Reader Service Card □ 


Windows/DOS Developer’s Journal - Page 31 


January 1992 










Listing 3 


/*** iDBCGetC - Retrieves character from kb buffer and reports status. 
* 

* written by: John G. Nelson, Pacific Software Publishing Inc. 

* copyright: Pacific Software Publishing Inc. 

* date: 11/90 

* purpose: To indicate type of character found in kb buffer 

* (if any) and to return that character in a double 

* byte character. If a double byte ANK character 

* found, it is converted to its single byte ANK code. 

* parameters: char *pdbcChar: Pointer to a double byte character. 

* return: Function returns int corresponding 


* 


to one of following values: 

★ 

0: 

Kb buffer is empty. 

* 

1: 

Single byte char found: 

★ 


dbcChar[0]= 1 byte char. 

★ 


dbcChar[l]= 0. 

★ 

2: 

Double byte char found: 

* 


dbcChar[0]” 1st byte of char. 

* 


dbcChar[l]= 2nd byte of char. 

★ 

3: 

Function key found: 

* 


dbcChar[0]= 0. 

★ 


dbcChar[l]= Key scan code. 


*/ 

int iDBCGetC( 

DBC *pdbcChar) /* Pointer to double byte character */ 
{ 

union REGS reg; 

unsigned char bScan, bChar; 


if (IkbhitO) { 


/* buffer is empty 
pdbcChar[0] - 0; 
pdbcChar[l] * 0; 

*/ 

return(0); 

); 


/* buffer has data 

*/ 

reg.h.ah ■ GETKEY; /* remove key from buffer 

int86(KEYBOARD, &reg, Sreg); 

*/ 

bScan = reg.h.ah; /* save scan code 

*/ 

bChar « reg.h.al; /* save character code 

pdbcChar[0] = bChar; 

pdbcChar[l] = bScan; 

*/ 

/* check if function key is present 
if (blsFuncKey(bScan)) { 

*/ 

/* function key found 
pdbcChar[0] = 0; 
pdbcCharfl] « bScan; 
return(3); 

*/ 

/* check if kanji char read 
) else if (blsDBC(pdbcChar)) ( 

*/ 

/* get second byte 

*/ 

reg.h.ah - GETKEY; 

int86(KEYB0ARD, &reg, &reg); 

pdbcChar[l] = reg.h.al; /* 2nd character code 

return(2); 

*/ 

/* single byte character found 
} else ( 

*/ 

pdbcChar[l] = 0; 
pdbcChar[0] ■ bChar; 


return(1); 

) 

) /* iDBCGetC */ 


/* End of File */ 



The AX keyboard BIOS functions 00H, 
01H, 02H and 10H, UH, 12H appear to 
have the same functionality. The dif¬ 
ference is that 10H, 11H, 12H can receive 
information from all of the AX 101/ex¬ 
tended keyboard keys, while the others 
work with the AT 84 keyboard but pro¬ 
vide no information about extended 
keys. 

FEP Control 

If a decision is made to control the 
FEP from within an application, the 
benefits of a transparent FEP are lost 
What is gained is the possibility of cus¬ 
tomizing input for the user, making the 
software more desirable and 
marketable in Japan. There are three 
basic levels of FEP control which can be 
assumed by an application (Figure 4). 

In the first level of control, the ap¬ 
plication doesn’t change. It continues to 
use the keyboard BIOS to get input 
from the keyboard buffer a byte at a 
time, now checking for a DBC entering 
the system. Level I FEP control refers to 
transparent FEP operation. 

The second level of FEP control al¬ 
lows the application to turn the FEP on 
and off as necessary. One application of 
this method would be to turn the FEP 
off when a menu is displayed on the 
screen to allow for single-byte naviga¬ 
tion, then turn it on when a user enters 
a DBC edit field. This would relieve the 
user of the work of switching the FEP 
off and on. At this level the screen is 
still handled by the FEP but the applica¬ 
tion can set the input region at the cur¬ 
sor position or at the bottom of the 
screen on the 25th line. The FEP is still 
hooked into the keyboard hardware in¬ 
terrupt and handles all conversions for 
the application, so the actual operation 
of the FEP is still largely transparent. 

With the third level of control, the 
FEP is no longer hooked into the key¬ 
board hardware interrupt. The FEP 
depends on the application to send 
key/scan codes. The application gets 
the scan and key codes from the key¬ 
board and can then selectively pass 
them to the FEP. The FEP still manages 
the same buffers and handles conver¬ 
sion as with the other levels, but now 
the application has access to those buf¬ 
fers. The application can have the FEP 
handle the display as it does with 
Levels 1 and 2. The application also has 
the option of displaying the internal FEP 
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buffers on its own in some customized 
way. 

Having the screen handled by the 
FEP at this level allows the application 
to act upon the input stream before 
receiving the FEP’s accepted translation, 
while insulating it from the hassle of 
screen update. 

When the screen is handled by the 
application, the FEP input region can be 
completely controlled. This level of con¬ 
trol is referred to as a fully integrated 
FEP. An example of an application that 
would benefit from a fully integrated 
FEP is a Japanese word processor, 
where the FEP could display in a scroll¬ 
able window all possible Japanese 
strings that could be converted from a 
user-entered sequence of phonetics. 
This type of control is possible with 
Level 3 FEP control. 

The AX specification has stand¬ 
ardized the FEP interface and is referred 
to as the MS_Kanji interface. Many of 
the Japanese PC FEPs have been 
adapted to the MS_Kanji specification 
and the others probably will follow. If 
you plan to control the FEP from the 
application, you should adhere to the 
MS_Kanji specification (it is beyond the 
scope of this article to address the in¬ 
tricacies of full FEP control). 

Printing 

Most Japanese printers still use the 
JIS character set, though some support 
Shift-JIS as well. The AX printer design 
was based on the Epson LQ series of 
printers and has a 24-pin printhead. 
DBCs are printed with 28 dots width, 
while SBCs are 14 dots. A DBC font 
download buffer has room for up to 94 
user-defined kanji fonts (gaiji). The 
graphic control system is the same as 
the PC/AT specification. 

The AX printer is based on the 
Japanese ESC/P protocol. Japanese ESC/P 
can be thought of as a superset of the 
ESC/P standard. Japanese-specific func¬ 
tions have been added as extensions. 
The printer will accept double-byte 
codes in both JIS and Shift-JIS format; 
however, an application should support 
JIS in order to be portable to all 
Japanese printers. Therefore, Shift-JIS 
should be converted to JIS when going 
to the printer. 

The algorithms which convert be¬ 
tween Shift-JIS and JIS are a bit terse 
but they work (see Listing 4). The magic 


of these routines has been included as 
part of the AX printer BIOS, functions 
51H and 52H. 

To print application-defined DBC 
fonts, an application must download 
the code as a user-defined kanji (gaiji). 
There are 94 JIS codes (7721H-777eH) 
available for this purpose. The user 
definable Shift-JIS DBC codes cannot be 
mapped to JIS using the Shift-JIS to 
JIS function, so an alternative mapping 
must be handled by the application. 
The font can then be downloaded and 
used for printing. Any of the SBC or DBC 
fonts stored in the printer’s ROM can be 
redefined in the download buffer, with 
the restriction that no more than 94 
DBCs or 182 SBCs be defined at any 
time. 

Vertical printing is a function of all 
modern Japanese printers. The vertical 
printing feature can be toggled on and 
off by an application. Vertical printing is 
a standard feature of Japanese word 
processors even though most applica¬ 
tions don’t support this feature because 
horizontal text is the most common for¬ 
mat for modern written Japanese. 

Conclusion 

The process of localizing a program 
from America to Japan can be ap¬ 
proached in three phases: DBC enable¬ 
ment, Japanization, and hardware port¬ 
ing. 

The first phase, DBC enablement, 
should modify the program so that it is 
DBC aware. This includes handling DBC 
input and editing, managing the display, 
and printing. The application should also 
be aware of the FEP (though if the FEP is 
to be controlled that should be imple¬ 
mented in the next phase). Line-draw¬ 
ing characters to be used by the ap¬ 
plication should be remapped and/or 
redefined in this phase. The added DBC 
processing features should be tested 
thoroughly before moving to the next 
step of the localization process. The AX 
computer is a perfect platform for the 
first phase of an IBM PC software 
localization, since the AX is completely 
compatible with the IBM AT. 

The second phase, Japanization, 
refers to adding Japanese-specific 
functionality to a program. Japanese 
Emperor date format, vertical printing, 
and FEP control are examples of 
Japanese-specific functions. Some func¬ 
tions may need to be disabled in a 
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Figure 4 



Adapted from "AX Technical Reference" Copyright (c) 1991. 


MS Kanji FEP Control Levels 


Listing 4 


/*** vShftJis2Jis - Converts Shift JIS code to JIS. 

* 

* purpose: Converts a char Shift JIS code to its corresponding 

* JIS code. 

* parameters: pcShJis: Pointer to shift JIS code. 

* pcJis : Pointer to Jis code for return. 

* return: None 

* modified: 

*/ 

void vShftJis2Jis ( 

DBC *pcShJis, /* pointer to Shift JIS code */ 

DBC *pcJis) /* pointer to JIS code for return */ 

{ 

int cl, c2; 

cl = (*pcShJis++) & Oxff; 
c2 * (*pcShJis) & Oxff; 
if (c2 <= 0x9e) { 

cl = (cl « 0x9f) ? (cl - 0x71)*2+l : (d-0xbl)*2+l; 
c2 -= Oxlf; 
if (c2 >= 0x61) ( 

c2-; 

} else { 

cl = (cl <= 0x9f) ? (cl-0x70)*2 : (cl-0xb0)*2; 
c2 -= 0x7e; 

} 

pcJis[0] * cl; 
pcJis[l] = c2; 

) /* vShftJis2Jis */ 

/* End of File */ 


Japanese version as they may not apply 
in Japan. For example, sorting files in a 
directory does not make sense in Japan, 
because files named using kanji can't 
be sorted the same way as English text 
Keeping English-specific functions will 
draw attention to the fact that the 
software has been adapted from 
another country and was not designed 
specifically for the Japanese user. 

The third phase is the port to the 
target machine architecture. By follow¬ 
ing this localization path, a functional 
AX version will have been created and 
can be marketed while ports to the 
other machines are approached. The 
NEC 9801 PC holds a large portion of the 
Japanese market and there are at least 
seven other PC markets in Japan. The 
AX currently holds between 10 and 15 
percent of the market and is growing. 

The Sanyo corporation of Japan has 
created a program called AX VGA/S 
which emulates the AX computer on an 
80386 IBM PC/AT with VGA (VGA is 
needed to display kanji). This allows 
English developers to retain current AT 
hardware while developing, localizing, 
and testing DBC-enabled programs. AX 
VGA/S will be available in the first 
quarter of 1992 from my company: 

Pacific Software Publishing, Inc. 

2737 77th Ave SE., Suite 210 

Mercer Island, WA 98040 

(206) 232-3989 

The minimum tools needed for DBC 
enablement are a Japanese computer, a 
front end processor, a Japanese printer, 
an English compiler, and an English 
editor (though the editor will appear a 
little buggy for the reasons discussed 
earlier). If translation of screen text is to 
be done by an in-house native Japanese 
speaker, a Japanese editor will be 
needed. □ 
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Internationalization 


Uncovering The 
NEC-9801 PC 

John G. Nelson 

Six major personal computer architectures dominate the market in 
japan: the NEC-9800, the AX, the Toshiba J-3100, the Fujitsu FMR, the IBM 
PS/5, and the Macintosh (Figure 1). Because the AX hardware platform is 
the only Japanese PC compatible with the IBM PC/AT, it is advisable for 
US companies to first localize to the AX and then move on to the other 
platforms. Flowever, since the NEC-9801 commands the largest share of 
the market, with more than fifty percent of the total installed base, 
programmers are most often asked to develop NEC-9800 versions of 
their software. 

The first Japanese NEC PC was introduced in 1982 and until recently, 
technical data in English has been virtually nonexistent. As a result, 
American shops wanting to penetrate the Japanese market have had to 
contract Japanese programmers to port their software to the NEC plat¬ 
form. Smaller companies have been deterred by the high costs; larger 
companies, by a reluctance to release source code under circumstances 
that allowed them little or no control of the project or the code. 

Recently, some documentation has been translated into English by 
NEC. The NEC PC-9800 Series Technical Data Book is now available in 
English and can be purchased ftym XLSoft International, 20 Claret, Ir¬ 
vine, CA 92714. Co'V VS3'i7<?y 

XLSoft is directly owned by NEC, so expect only NEC support Also 
remember that this reference is a translation and that omissions and 
errors are likely to have resulted. I am not aware of any other English 
books that cover the NEC-9800 series. 



John G. Nelson holds a B.S. in computer science from Colorado State 
University. He has been with Pacific Software Publishing for two gears 
as the primary Japanese localization specialist. Pacific Software 
Publishing provides Japanese localization, translation, education and 
consulting services at all levels. In his spare time, John works as a 
class V Whitewater rafting guide, ski instructor, and alpine climbing 
guide. He can be reached at PSP, Inc., 2737 77th Ave. S.L, Mercer 
Island, WA 98040. (206) 232-3989. 
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Figure 1 

Japanese Microcomputer Market 
1989 PC Market Share 

NEC-9801 56% 


Fujitsu 11% 

IBM 7% 



Toshiba 10% 


AX 8% 


Other 8% 


Much of the NEC is still officially undocumented. Some 
Japanese hacker journals publish interesting finds but these 
typically do not get translated. Consequently, many of the un¬ 
documented intricacies of the machine are left to be redis¬ 
covered and documented by American localization specialists. 
NEC will probably provide translations of more of its documen¬ 
tation over the next few years, given that while NEC is the 
standard for Japan, the rest of the world adheres to a different 
standard. In fact, the benefits of defining a NEC standard open 
architecture are probably now being seriously considered: Epson, 
having built the PC286 and PC386 machines from the ground up, 
claims to be at 95 percent with the NEC-9800 series. 

If a Japanese version of an application is to run on the 
NEC-9800, platform differences in the hardware must be ad¬ 
dressed: the fundamental hardware differences between the 
NEC-9800 series and the IBM PC are the subject of this article. 
(The application will also have to be DBC enabled to handle 
double-byte processing; see "Japanese Double Byte Character 
Processing” elsewhere in this issue.) 

NEC 9800 Series 

NEC's original 8086 PC-9801 PC, introduced in 1982, has un¬ 
dergone multiple modifications and many models have been 
derived. There are four distinct NEC model lines including PC- 
9801 laptop, PC-9801 compact, PC-9801 main, and PC98 high 
resolution. The NEC-9801 Series support Intel chips ranging from 
the 8086 and V30 (NEC's version of the Intel 8086 with minor 
extensions) to the i80486 to the V30 combo models. In the V30 
combo models, the V30 chip coexists with a newer Intel chip in 
the same machine. These are not parallel processor machines-, 
only one of the two chips can operate at any one time and chip 
selection is controlled by dip switch settings. This feature was 
designed to maintain compatibility with the early 8086 machines. 
The extra V30 chips are used only infrequently now, and have 
been discontinued from the latest NECs. 

The number of models in the NEC-9800 series is extensive. 
Rather than try to name them all, I list here some basic 
naming conventions: 

PC - Starts all model names 

Resolution: 

98 - HiRes Machined 120x750) 

9801 - Normal Res Machine(640x400) 


Box Type: 

L - Laptop Series 
D - Desktop Series 
N - Notebook Series 

Marketing Letters: 

H - Hyper Series (beginning in 1990) 

R - Revolution Series (beginning in 
1988) 

FA - Factory Floor Model 
M - Standard Model 
X - Extended Graphics 

CPU: 

A - 386 
L - 386 
S - 386 SX 

Floppy Drive Model: 

F - No Floppies (1st Series) 

U - 3 1/2 

V - 5 1/4 (V30 CPU added) 

Drive Specs: 

1 - 1 floppy 

2 - 2 floppy 

3 - 2 floppy/20MB HD 

4 - 2 floppy/40MB HD 

The naming rules are outdated and inconsistent, making it 
hard to decipher the model numbers. The most popular model 
is the NEC-9801DA2 (Normal Res. 386 Desktop with 2 floppies). 
If you have a 386 protected mode application this is a good 
model for development. Otherwise, a standard model with 
normal resolution (such as the PC-9801VX) is the suggested 
platform for the localization or development project. Unless 
specifically targeting the high resolution PC-98 market, avoid 
localizing to that platform because the majority of the in¬ 
stalled base has normal resolution. 

What’s Inside? 

The good news is that the NEC-9800 is based on the Intel 
8086 microprocessor and runs a version of Japanese DOS. I'll 
use the IBM PC as the ground zero standard to isolate how 
the NEC-9800 deviates. The major differences lie in the BIOS, 
the structure of VRAM, and changes in the interrupt vectors. 

An interesting aside: while DOS services are all still avail¬ 
able in the same form, DOS treats the disk drives in a different 
manner. Specifically, the boot drive always becomes “A:”, 
whether floppy or hard disk, and the others are named in 
logical subsequent order. This convention may spell disaster 
for unsuspecting install programs. 

Japanese DOS version numbers are rather misleading that 
depend on statically labeled disk drives. For instance, the 
latest NEC Japanese DOS version is v3.3, while Epson's latest is 
labeled as version v4.0. In reality, the latest version of 
Japanese DOS is v3.21. The higher numbers are adopted for 
marketing purposes. 

The basic memory map structure for the normal and high 
resolution machines is basically the same as for the IBM (Figure 
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2). It is safe to assume that all NEC-9800 series machines will 
have at least 640 KB of RAM. Typically 450 KB is available 
after DOS and the front-end processor are loaded. 

The CRT 

The structure of text VRAM is very different from that of 
the IBM PC. For instance, the characters and their attributes 
are stored in separate memory locations (the IBM PC inter¬ 
leaves character and attribute bytes). The character portion 
of NEC VRAM consists of 8KB starting at A0000H and the at¬ 
tribute portion is 8KB starting at A2000H. Each word in the 
character portion of memory describes a single character cell 
on the screen. Each character cell is either a single English or 
Katakana character, or one-half of a kanji glyph (each kanji 
character takes up two character cells on the screen). A nor¬ 
mal screen has 25 lines and 80 single-byte character cells. 
You can display single-byte and double-byte characters on 
the screen at the same time, so the number of characters a 
row holds depends upon what characters you use. 

The NEC video controller imposes some strange require¬ 
ments on double-byte characters. To display a double-byte 
kanji character, you first have to translate from Shift-JIS 
double-byte codes to JIS. Next, you subtract 20H from the 
first byte of the DBC. Finally, you store the DBC twice in con¬ 
secutive memory locations as shown in Figure 3 (a total of 
four bytes), with one bit flipped. Although a single DBC code 
specifies a kanji character, the video controller prefers to 
view each kanji character as a two-character cell, the left and 
right halves of the glyph. For each character cell in VRAM, the 
corresponding word offset at A2000H contains an attribute 
byte; only even addresses are valid in this 8KB page. 

The normal resolution machines have two graphic screens. 
Eight colors are standard, though some models have extra 
graphic VRAM to allow for 16. The resolution scale is stepped up 
from English systems to allow intricate kanji fonts to be displayed: 
normal resolution is 640x400 and high resolution is 1120x750. 

A special screen mode which allows a graphics screen to 
be superimposed on a text screen is also available on all 
models. This is possible because text and graphic VRAM are 
stored in separate locations. If the background color is set to 
something other than black, then the foreground color cannot 
be set To get around this limitation, some applications use 
the standard superimpose feature to set the foreground color 
of a text screen and then superimpose a background color as 
a graphic screen. 

The video interrupt vector changes from 10H to 18H and is 
shared by the keyboard. The specific services of the normal 
resolution machine video BIOS are listed below: 

0AH - Set video mode 
0BH - Read video mode 
0CH - Start text screen display 
0DH - Stop text screen display 
0EH - Set single display area 
0FH - Set multiple display area 
10H - Set cursor type 
11H - Display cursor 
12H - Terminate cursor 
13H - Set cursor position 
14H - Read font pattern 
16H - Initialize text VRAM 
1AH - Define user character 


Figure 2 


FFFFF 

E8000 

E0000 

COOOO 

A8000 

A0000 

00000 

NEC-9801 Normal Resolution Memory Map 

Notice that most of the function numbers have changed, 
some of the BIOS services are no longer available, and the 
calling conventions in many cases have changed. 
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Figure 3 

Character Storage in Text VRAM 


Single Byte Character Display 



Unused Kanji Side Bit 

0:Left Side 
l:Right Side 


Keyboard 

The keyboard interrupt vector changes from 16H to 18H 
and, as noted, is shared by the video BIOS. The first three 
functions ( 00H-02H) remain basically the same on the NEC, 
though the calling conventions are a little different. Other ob- 
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vious BIOS service differences for the normal resolution 
machines follow. 

Extra Functions: 

03H - Initialize keyboard 
04H - Key pressed 

Missing Functions: 

03H - Set repeat/time cycle 
05H - Write key 

Double-byte characters enter the system via a front-end 
processor in the form of Shift-JIS characters. Typically, a NEC- 
9800 series application supports Shift-JIS internally and con¬ 
verts to/from JIS when performing screen or printer I/O. 

Printer 

The PC-9800 printer BIOS supports basic I/O for Centronics 
interfaces. The printer interrupt vector is 1AH (changed from 
17H on the IBM. The services for the printer BIOS for normal 
resolution machines follow. 

10H - Initialize 

11H - Output single byte 

12H - Sense status 

Almost all Japanese printers support the JIS standard. 
Before a double-byte character is sent to the printer, there¬ 
fore, the character must be converted from Shift-JIS to JIS. Be¬ 
cause the printer BIOS services do not provide a function to 
perform this task, the conversion must be handled by the ap¬ 
plication, as on the AX (see “Japanese Double Byte Character 
Processing" elsewhere in this issue for an example). 

Timer 

There is no 1CH equivalent periodic timer interrupt on the 
NEC-9800. In order to emulate a periodic timer interrupt, ap¬ 
plications can use the interrupt OAH, which is the video vertical 
retrace interrupt The frequency of this interrupt varies be¬ 
tween display types, so the application will have to adjust to 
the particular model (for the timing chart for this interrupt, see 
PC-9800 Series Technical Data Book, p. 570). 

This interrupt is disabled by default, so the 8259 PIC’s IMR 
must be reprogrammed. To activate the interrupt for periodic 
retrace, place any data twice into port 64H (see PC-9800 Series 
Technical Data Book, p. 98, nt. 2). 

Conclusion 

Because the NEC-9800 series differs so dramatically from 
the IBM PC architecture, American developers should plan to 
build a fully DBC-enabled version before porting to the NEC 
platform. Since the AX is compatible with the IBM PC, a stable 
DBC-enabled version can be produced in this familiar environ¬ 
ment. The NEC-9800 series is well rooted in Japan, so targeting 
it for a localization makes sense. However, be prepared for 
turmoil in the strange and weirdly wonderful land of the NEC- 
9801. Many surprises await you. □ 
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Internationalization 


DOS 

Internationalization 

Support 


Craig Murray 


DOS version 3.3 represented Microsoft’s first serious attempt at 
national language support (NLS). if you develop software for 
foreign markets, you need to understand the services DOS 
provides for internationalization. Since both Windows and OS/2 
base their internationalization support on the DOS services, 
studying the DOS services is useful even if you no longer use DOS 
directly. This article describes the DOS services and their 
shortcomings. For complete documentation on DOS NLS services, 
a copy of the Microsoft MS-DOS Programmer's Reference: Version 
5.0 (from MS-Press, ISBN 1-55615-329-5) is essential. All references 
to DOS in this article apply to DOS version 5.0 (U.S. version) unless 
otherwise stated. 


Craig Murray is a Project Manager for Network Dynamics, Inc 
His background includes software development in C for DOS-based 
and Unix-based environments. Mr. Murray has had exposure to 
internationalization issues through the maintenance and technical 
support of the Foreign Language Pre-Processor and the String Ex- 
ternalization Tools. He currently holds a B.S in computer science. 
You may contact him at (804) 220-8871. 
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National Language Issues 

Even after translating your software’s prompts, help mes¬ 
sages, and other textual information to the target language(s), 
you still have to address the basic issue of typing, displaying 
and printing any characters in the target language that are 
not defined by the default character set (code page) provided 
by DOS. DOS can display or print up to 256 different characters 
(the ASCII character set comprises the first 128 characters). This 
obviously is not enough characters to support all languages; 
some languages need a different character set, so you have to 
have a means of switching characters. The problem is com¬ 
pounded if your software switches at runtime between lan¬ 
guages with different character sets. For example, a software 


Belgium 

Brazil 

Canadian-French 
Czechoslovakia 
(Czech, Slovak) 
Denmark 

Finland 

France 

Germany 

Hungary 

International English 
Italy 

Latin America 
Netherlands 

Norway 

Poland 

Portugal 

Spain 

Sweden 

Switzerland 
(French, German) 
United Kingdom 
United States 
Yugoslavia 

Countries and Regions Covered by Six Standard Code Pages 




Table 2 


INT 

Function 

Minor 

Code 

Name 

21H 

6601H 


Get global code page 

21H 

6602H 


Set global code page 

21H 

440CH 

4AH 

Select code page 

21H 

440CH 

4CH 

Start code page 
preparation 

21H 

4403H 


Write control data to 
character device 

21H 

440CH 

4DH 

End code page 
preparation 

21H 

440CH 

6AH 

Query prepare list 

2FH 

AD80H 


Get KEYB.COM version 
number 

2FH 

AD81H 


Set KEYB.COM active 
code page 

2FH 

AD82H 


Set KEYB.COM county 
flag 

2FH 

AD83H 


Get KEYB.COM county 
flag 

2FH 

1400H 


Get NLSFUNC.EXE 
installed state 


DOS Code Page Services 


package might want to be able switch between Czechos¬ 
lovakian and German at runtime. 

Typing and displaying the characters on the screen is one 
matter, printing them is another. For each language's charac¬ 
ter set, the printer must know how to print each character in 
the set This involves downloading fonts for each character set 
containing characters not included in the built-in fonts of the 
printer. 

Finally, a point of consideration when developing a system 
for foreign end-users: they will expect a keyboard layout and 
conventions settings applicable for that country. Therefore, 
any use of currency, date, time, and so on, within your 
software must take these factors into account as well. 

Code Pages 

DOS can use up to 256 different characters when displaying 
or printing text; each such character set is referred to as a 
"code page.” The set of characters in use at any given time is 
called the “active code page." Each of the different countries 
supported by DOS (see Table 1) uses a code page that con¬ 
tains the appropriate character set for that country (with the 
first 128 characters of all code pages being the ASCII character 
set). 

Hardware code pages are code pages that come built into 
your system's devices, your keyboard, screen, and in some 
instances, your printer. This is the default code page DOS uses 
unless you specify a different code page. 

A prepared code page is an alternate set of 256 characters 
stored in code page information (.CPI) files. A .CPI file is also 
called a font file, because it contains font information for a 
display adapter or a printer. DOS version 5.0 supplies six 
prepared code pages that you can use in addition to or in¬ 
stead of the hardware code pages built into your devices. 

DOS supplies a rather convoluted set of commands, TSRs, 
and device drivers that allow users to switch code pages. The 
user has to switch code pages if the default code page is not 
acceptable, or if, during a session, it's necessary to switch be¬ 
tween languages requiring different character sets. For a 
printer or a display adapter, switching code pages involves 
transmitting the font information in a .CPI file to the ap¬ 
propriate device driver. For the keyboard, switching code 
pages involves notifying memory-resident software that 
dynamically translates the keystrokes that arrive from the 
keyboard. 

DOS Commands 

The COUNTRY^ line in CONFIG.SYS allows you to specify 
country-specific conventions for displaying dates, times, cur¬ 
rency, character sort order, and filename characters for each 
country supported by DOS. Country information is built into 
DOS; the default U.S. version of DOS knows about the countries 
shown in Table 1. For other countries, you may have to buy a 
special version of DOS. 

KEYB.COM is a TSR that controls which characters (from the 
active code page) are present and how they are arranged on 
the keyboard. KEYB.COM supports standard keyboard arrang- 
ments for each country that DOS handles. 
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Besides its many other functions, the MODE command also 
handles loading and selecting alternate code pages for dis¬ 
plays and printers. If you have specified (in a DEVICE = line in 
CONFIG.SYS) the appropriate device driver for your printer 
(PRINTER.SYS) or display (DISPLAY.SYS), you can use MODE to 
load an alternate code page for that device. DOS ships with a 
DISPLAY.SYS that can load the standard six font (.CPI) files 
for an EGA or VGA display. DOS also ships with a PRINTER. SYS 
that handles the standard six font files for three models of IBM 
printers (the 4201, 4208, and 5202). 

NLSFUNC.EXE is a TSR that allows DOS to recognize and 
switch between prepared code pages for all devices at the 
same time using the CHCP command. Users have to load 
NLSFUNC only if they need to switch code pages at runtime. 
CHCP is a resident DOS command that activates the specified 
code page for all devices (keyboard, display, and printer). 

DOS API Functions 

The DOS API provides a variety of functions related to inter¬ 
nationalization. These functions fall into three broad 
categories. First, you can manipulate code pages in order to 
determine and control how the keyboard, display, and printer 
handle characters. Second, you can inspect and change the 
current country code and obtain information about the con¬ 
ventions associated with the current country code (such as 
how to display dates, currency, and so on). Finally, DOS 
provides services for language-independent sorting and file 
naming. Most of these services appeared in DOS 3.3; later ver¬ 
sions have some enhanced capabilities and Microsoft did not 
document all of them until DOS 5.0. 

Table 2 shows the DOS API functions related to code pages. 
You may want your application to use function 6601H to in¬ 
spect the current code page in order to tailor some aspect of 
the user interface to a particular character set Fortunately, 
you can ignore most of the other functions in this table unless 
you want your application to be able to switch code pages for 
the user. 

The DOS API gives you the ability to write software to 
duplicate the effects of the KEYB, CHCP, and MODE commands. 
This is possible, but tedious. For example, your application can 
read a .CPI font file into memory, issue an interrupt to start 
code page preparation, write the font file data to the device, 
issue an interrupt to end code page preparation, then select a 
code page corresponding to one of those fonts. 

Table 3 shows the DOS API services related to country in¬ 
formation. You can discover the current country code, switch 
to a different country code, and get a table of preference in¬ 
formation. Use the extended country information to make ap¬ 
propriate changes to your user interface, including how you 
display dates, times, money, lists, and decimal points. 

Table 4 shows the DOS API support for character com¬ 
parisons. When you deal with a foreign language, you cannot 
use simple string comparison functions like strcmp(). Does an 
“a” sort before or after a normal “a"? DOS does not handle all 
the problems related to sorting, but it does supply simple, 
language-independent tables for sorting strings and keeping 
illegal characters out of file names. 
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Function 6506H returns a pointer to a table of comparison 
weights that is correct for a given code page. To compare two 
characters, you use the characters to index into this table and 
then compare the byte values there. If you want to perform a 
case-insensitive string comparison, you need the table 
returned by function 6502H. This table correctly maps ex¬ 
tended characters to their uppercase equivalents. In DOS 5.0, 
you can also call functions to uppercase a string or character 
for you directly. 

DOS also maintains two character tables for filenames. One 
table (returned by function 650SH) simply indicates which 
characters are legal in filenames. The other table maps ex¬ 
tended filename characters to uppercase. 

DOS also contains some primitive information for handling 
double-byte character sets, such as Kanji. For more informa¬ 
tion, see "Japanese Double Byte Charater Processing" in this 
issue. 

DOS NLS Shortcomings 

DOS (the U.S. version) provides only six code pages covering 
the languages (character sets) shown in Table 1. If you need 
to use some other language you have to purchase a special 
version of DOS. (See “Foreign Language Versions of DOS” 
below.) 

DOS's code pages are not always complete. For example, 
neither the default nor the alternate code page for French 
contains a character to represent the ligature “oe," among 
others. 

DOS provides only the printer, sys device driver, which 
interfaces only with selected IBM Proprinters and Quietwriters. 
To print on a different printer, you would need to write/buy a 
new device driver to map the character sets (code pages) and 


Table 3 


INT 

Function 

Name 

21H 

38H 

Get/set country information 

21H 

6501H 

Get extended country information 

DOS Country Information Services 




Table 4 


INT 

Function 

Name 

21H 

6502H 

Get uppercase table 

21H 

6504H 

Get filename uppercase table 

21H 

6505H 

Get filename-character table 

21H 

6506H 

Get collating sequence table 

21H 

6507H 

Get double-byte character set 
information 

21H 

6520H 

Convert character to uppercase 

21H 

6521H 

Convert string to uppercase 

21H 

6522H 

Convert ASCIIZ string to uppercase 


Collating Sequence Information 


download the appropriate font to the printer before passing 
on the ASCII values. 

One way of overcoming some of these DOS shortcomings is 
to develop your own language-switching TSR hooked to inter¬ 
rupt 9H (this is how KEYB. COM works). Within the TSR, you can 
implement a character set switching scheme. This would in¬ 
volve defining your own character sets and corresponding 
fonts, keeping track of the current character set definition, 
defining a corresponding keyboard layout, and mapping the 
keystrokes entered by the user to the proper character set 
value. The TSR can read the keyboard (using I NT 16H, for ex¬ 
ample), map the keyboard scan code to an appropriate char¬ 
acter set value based on the current character set and key¬ 
board layout, and send that character to the screen. You 
would use a similar approach for any printer drivers. Develop¬ 
ing such a TSR is not a trivial matter, as attested by the rela¬ 
tively small number of products on the market providing such 
support. 

Foreign Language Versions Of DOS 

Subsidiaries of Microsoft offer versions of DOS for many 
foreign languages, countries, and regions. These versions in¬ 
clude the Western European cultures (Spanish, French, Ger¬ 
man, British, Portuguese, Danish, Finnish, Norwegian, Swedish, 
Dutch, Italian, Greek, etc.), French-Canadian, the Latin American 
cultures, the Far East cultures (Kanji, Flanguel, Taiwanese- 
chinese, etc.), Russian, and Flebrew. A list of Microsoft sub¬ 
sidiaries is available from Microsoft International Customer Ser¬ 
vice at (206) 936-8661. 

Arabic languages have their own special set of problems 
for international applications. Arabic languages are read and 
written right-to-left, not left-to-right. Arabic characters also re¬ 
quire contextual analysis in order to determine which of four 
different shapes the Arabic characters should have, depending 
upon their location in a word or phrase. 

Available directly from Microsoft International Customer 
Service at (206) 936-8661, Arabic DOS 3.3 is a fully localized 
Arabic version of DOS. It provides a complete Arabic software 
development environment, a new user interface (the menu- 
driven Arabic DOS Manager), and complete national language 
support for all Arabic-speaking countries. Arabic DOS allows 
the user to control presentation orientation of the screen 
(right-to-left versus left-to-right) and to access Arabic exten¬ 
sions to the application program interface. Most important, 
Arabic DOS allows the user to run most off-the-shelf and exist¬ 
ing custom DOS applications without modification. Users 
preferring English can exit the Arabic DOS Manager and work 
with the English-based COMMAND. COM, while still having access 
to all the feature of Arabic DOS. 

Summary 

DOS has made significant progress in supporting a variety 
of languages and countries. Even today, though, most applica¬ 
tions do not inspect the country information and alter their 
user interfaces appropriately. Even fewer applications take ad¬ 
vantage of the DOS collating sequence information to correctly 
sort foreign language character strings. DOS can provide na¬ 
tional language support, but it will always be up to program¬ 
mers to design international applications. □ 
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Using Generic 
Windows API 
In Pascal 

Richard Sands 


If you use Borland’s Turbo Pascal and the thought of not 
using their Object Windows Library (OWL) makes you shudder, 
you are not alone. OWL is an object-oriented “framework” that 
does much of the dirty-work required to build a Windows 
program. It's still possible, though, to use the generic Windows 
API to write complete programs. 

Writing programs using just the generic API means that 
you must now do "by hand” all of the chores that OWL per¬ 
forms for you, such as window class registration, creating pro¬ 
cedural instances, and handling messages. Many of these 
tasks can be implemented in a template fashion, and as 
templates, they can be tailored exactly to your program's 
needs with no additional overhead. 

Why go to the trouble of writing these complex tasks by 
hand? First, there are a lot of programs written in C out in the 
world, including most of the examples in the many Windows 
technique books. To use the examples you need to port them 
to Pascal. To minimize errors, you normally would try to keep 
the same basic structure as in the original example. It's a good 
exercise to translate a C program to Pascal using the generic 
API, and then translate it again using the Object Windows 
Library. This gives you a firm understanding of what the API is 
doing, and how OWL relates to it. 

Second, if you want to write Dynamic Link Libraries (DLLs), 
then it is strongly suggested that you use the generic API. The 
most important reason lies in the way that Turbo Pascal allo¬ 
cates memory with it's heap managment routines. In DLLs, the 
suballocation scheme that Turbo Pascal uses to allocate 
memory is disabled. In other words, each call to new or get- 
mem will have allocated a new memory block, and Windows 
has a system-wide limit of 8,000 blocks. When you write a 
DLL using OWL, it’s going to allocate many items on the heap 
and, in the process, use up many of those memory handles. 


Richard Sands is the senior programmer for Management 
Compensation Group NW Inc., an Executive Benefits company. 
He has been programming microcomputers since 1978, primari¬ 
ly with Pascal and C. Besides programming, brewing beer is 
one of his favorite activities. 
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Listing 1 (byel.pas) 

{$M 2048,1024,R-,S-,D-,L-,N-,A-} 

Program Bye; 

(* BYE.PAS - Quick Exit For Windows in Generic Windows API 
* Written by Richard R. Sands in Turbo Pascal for Windows 
*) 

($R BYE1} 

USES 

WinTypes, WinProcs; 

CONST 

AppName * 1 Bye 1 ; 

Confirm : Boolean = FALSE; { Confirm Windows Shutdown? ) 


idm_Quit * 100; { Sys Message Command: Quit Windows } 

idm_Confirm ■ 101; { Sys Message Command: Confirm Exit ) 

idm_0S ■ 102; { Sys Message Conmand: Execute DOS Shell ) 

idm_About = 103; { Sys Message Command: Show About Dialog ) 

{.} 


function About(Dialog: hWnd; Message, wParam: Word; IParam: Longint): Bool; EXPORT; 
begin 

About := True; 
case Message of 
wm_InitDialog: EXIT; 

wm_Command : if (wParam = id_0k) or (wParam * id_Cancel) then 
begin 

EndDialog(Dialog, 1); 

EXIT 

end; 

end; 

About := False 
end; 

{.} 

procedure DoAbout(Window:hWnd); 
var AboutProc: tFarProc; 
begin 

AboutProc := MakeProcInstance(@About, hlnstance); 

DialogBox(hInstance, 'AboutBox 1 , Window, AboutProc); 

FreeProcInstance(AboutProc) 
end; 

(.-.) 

Procedure SetConfirmState; 

{ Sets the [BYE] 

Confirm=Y/N 
WIN.INI setting } 
var Buffer: Array[0..1] of char; 
begin 

if Confirm then Buffer[0] := ‘Y 1 
else 

Buffer[0] := 'N'; 

Buffer[l] := #0; ( Null terminate the String ) 

WriteProfileString(AppName, 'Confirm', Buffer); 
end; 

{.) 

procedure Quit(Window: hWnd); 
begin 

if Confirm then 
begin 

MessageBeep(O); 

if MessageBox(Window,'Are you sure you want to exit Windows?', 'Exit Windows?', 
mb_IconQuestion + mb_OkCancel) * id_Cancel then 

EXIT 

end; 

SetConfirmState; { Write our Confirm=Y/N entry in WIN.INI ) 

ExitWindows(0, 0) { See 'ya } 

end; 
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Listing l — Cont’d 

{.} 

Procedure ToggleConfirm(Window : hWnd); 
var SysMenu : hMenu; 
begin 

SysMenu := GetSystemMenu(Window, FALSE); 

Confirm ;= NOT Confirm; 
if Confirm then 

CheckMenuItem(SysMenu, idm_Confirm, mf_byCommand + mf_Checked) 
else 

CheckMenuItem(SysMenu, idm_Confirm, mf_byCommand + mfJJnChecked) 

end; 

{.) 

function WindowProc(Window: hWnd; Message, WParam: Word; LParam: Longint): Longint; EXPORT; 

{ This is the main message handling routine. If there is a System Menu 
command, then wm_SysCommand is sent with the menu option. Otherwise, 

I check for a double click on the icon, which is sent as a 
wm_QueryOpen message, as a signal to close Windows } 


The third and best case for using the generic API is in writ¬ 
ing small utilities. If you do not require all the facilities of Win¬ 
dows, then not having the overhead of OWL significantly 
reduces the size of the .exe and the amount of memory it 
requires to run. However, the larger the program, the more 
likely you are to reach the point where you are duplicating 
the functionality of OWL with the generic API - and at a higher 
cost of maintenance and program complexity! 


The bye program in Listing 1 (byel.pas) is written entirely 
using the generic API. The binary resource file for this listing 
( byel.res) is on the code disk. This program was modified 
from the generic.pas sample included with Turbo Pascal for 
Windows and provides a simple framework that most 
programs can adhere to. Notice that in the MinMain procedure, 
you need to set up a tWndClass record in order to register 
your program’s window class. After registering the class, creat¬ 
ing your main window, and doing a few initialization tasks, 


C and C++ DOCUMENTATION 
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• Calculates "Cyclomatic" path complexity for functions and system 
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filel 
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file2 

—sub 2 
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1—sub3 

file2 
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filel 
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C-CALL™($59) FUNCTION HIERARCHY 
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C-CMTl$59) FUNCTION COMMENT 
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Listing 1 — Cont’d 


begin 

WindowProc := 0; 
case Message of 
wm_SysCommand: 

case wParam of 
idm_About : 
idm_Confirm: 
idm_0S : 
idm_Quit : 
end; 

wm_QueryOpen: 
begin 

Quit(Window); 

{ If returns 0 then we cannot open 
restore window function } 

EXIT 


DoAbout(Window); 

ToggleConfirm(Window); 

WinExec('Command.Com 1 , sw_Normal); 
Quit(Window); 


( Double click on Icon } 


this suppresses the 


end; 

wm_Destroy: 
begin 

SetConfirmState; { Update WIN.INI with Confirm Setting ) 
PostQuitMessage(O); 

EXIT 


end; 

end; 

{ For all messages we don't care about, they are handled by the 
“default window process" } 

WindowProc := DefWindowProc(Window, Message, wParam, IParam) 
end; 


(.} 

procedure WinMain; 
var Window : hWnd; 

Message : tMsg; 

SysMenu : hMenu; 

Buffer : Array[0..1] of char; 
const 

WindowClass: tWndClass = ( 
style : 0; 
lpfnWndProc; QWindowProc; 
cbClsExtra : 0; 
cbWndExtra : 0; 
hlnstance : 0; 
hlcon : 0; 
hCursor : 0; 
hbrBackground: 0; 

IpszMenuName : AppName; 

IpszClassName: AppName); 
begin 

if hPrevInst = 0 then 
begin 

WindowClass.hlnstance := hlnstance; 

WindowClass.hlcon := LoadIcon(hInstance, 'ICON'); 

WindowClass.hCursor : = LoadCursor(0, idc_Arrow); 

WindowClass.hbrBackground := GetStockObject(white_Brush); 
if not RegisterClass(WindowClass) then Halt(255); 
end 
else 

Halt(0); { Only One Instance Allowed ) 

Window := CreateWindow(AppName, AppName, 
ws_0verlappedWindow, 

cwJJseDefault, cwJJseDefault, cwJJseDefault, cwJJseDefault, 
0, 0, hlnstance, nil); 

SysMenu := GetSystemMenu(Window, FALSE); 

( Add Items to the System Menu } 

AppendMenu(SysMenu, mf_SysMenu + mf_Separator, 0, NIL); 

AppendMenu(SysMenu, mf_SysMenu, idm_Quit, '&Exit Windows'); 

AppendMenu(SysMenu, mf_SysMenu, idm_Confirm, 'Confirm &Shutdown'); 

AppendMenu(SysMenu, mf_SysMenu, idm_0S, '^Operating System'); 

AppendMenu(SysMenu, mf_SysMenu, idm_About, '&About Bye...'); 


Page 46 - Windows/DOS Developer’s Journal 


January 1992 




Listing 1 — Cont’d 

GetProfileString(AppName, 'Confirm', 'N', Buffer, sizeof(Buffer)); 
if Buffer[0] « 'Y' then 
ToggleConfirm(Window); 

ShowWindow(Window, sw_Minimize); { This minimizes the window ) 

{ The application's message loop ) 
while GetMessage(Message, 0, 0, 0) do 
begin 

TranslateMessage(Message); 

DispatchMessage(Message) 

end; 

Halt(Message.wParam) 
end; 

{.} 

begi n 
WinMain 
end. 

{ End of File } 


the program merely runs in a loop receiving and handling 
messages sent to it by Windows. Each message received is 
sent to the UindowProc procedure. Note that this is an ex¬ 
ported procedure, exported routines are similar to far 
routines (they are far) but can be thought of as being fur¬ 
ther, since these routines are not just intrasegment calls, but 


are called by Windows itself. Another exported procedure is 
the routine that handles the code for the About Dialog Box. 
Since the dialog resource is loaded from disk, the AboutProc is 
created to handle the various controls of the dialog box, in 
this case, the OK button. 


Corrected Listing 2 for Stephen Nebel’s 

“A Fast Get-Length-of-ASCIIZ,” vol. 2, no. 11. 

string DB "This is 

a string",0 

cld 


clear direction 

mov 

si .offset string 

load offset 

mov 

cx,si 

get offset into counter 

repeat: 



lodsw 


load word from string 

test 

ah,al 

zero yet? 

jz 

end repeat 

if so exit and adjust 

lodsw 


load word from string 

test 

ah,al 

zero yet? 

jz 

end repeat 

if so exit and adjust 

lodsw 


load word from string 

test 

ah,al 

zero yet? 

jnz 

repeat 

if not repeat 

end repeat: 


sub 

si,cx 

get unadjusted count 

mov 

cx,si 

move to return register 

cmp 

al ,0 

is lead byte zero? 

jz 

adj two 

if so adjust back two 

dec 

cx 

else adjust back one 

jmp 

adj end 

then exit 

adj two: 



sub 

cx,2 

adjust back two 

adj end: 
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Add TIFF, PCX, or GIF support to your 
Windows 3.0 Application without 
learning to work with file formats! 

TIFF SDK For Windows is a complete set of easy-to-use tools for I 
adding TIFF 5.0 support to your application without learning the I 
complexityoflagimageFileFormat. Featuresindudesupportfor: I 
Group 3 and Group 4 fax file formats, LZW and Packbit compres- I 
sion, 24-bit color images, chained images and device independent I 
bitmaps. Includes full documentation plus a sample application I 
complete with source code. Only $299.95 I 

PCX SDK For Windows allows addition of the PCX file format to I 

an application. Comes with full documentation, including asample I 
program with source code. Only $149.95 I 

GIF SDK For Windows adds the latest GIF 8-bit color support to I 

your application. Includes documentation plus a sample program I 
complete with source code. Only $149.95 I 

IMAGE SDK For Windows contains functions to read, write, and I 

manipulate Microsoft Windows CLP, WMF, BMP, and MSP file I 
formats. Zooms, inverts, & rotates bitmaps. Comes with documen- I 
tation, sample program and source code. Only $199.95 I 

X, BLACK ICE SOFTWARE INC. 

f Tv ^ Crane Road, Somers N.Y. 10589 

' T' ft' TEL: (914) 277-7006 FAX: (914) 276-8418 

| VISA/M.C./C.O.D/CHECK 

II 

□ Request 139 on Reader Service Card □ 

Windows/DOS Developer’s Journal — Page 47 


January 1992 



























Listing 2 (bye2.pas) 

{$M 2048,1024,R-,S-,D-,L-,N-,A-} 
program Bye_With_0wl; 


(* BYE2.PAS - Quick Exit For Windows - In Object Windows Library 
* Written by Richard R. Sands in Turbo Pascal for Windows 
*) 


USES 

WObjects, WinTypes, WinProcs; 


{$R Bye2.Res) 


CONST 

AppName = 1 Bye2'; 

IniAppName = 'Bye'; { As listed in WIN.INI } 


idm_Quit « 100; { Sys Message Command: Quit Windows } 

idm_Confirm =101; { Sys Message Command: Confirm Exit ) 

idm_0S = 102; { Sys Message Command: Execute DOS Shell } 

idm_About = 103; { Sys Message Command: Show About Dialog ) 


type 

{ Define a TApplication descendant } 
tWExitApp = object(tApplication) 
procedure InitMainWindow; virtual; 
end; 


pByeWin = A tByeWin; 
tByeWin = object(tWindow) 

Confirm: Boolean; { ask before quitting? } 


{ Window/Object Setup } 

constructor Init(AParent: pWindowsObject; ATitle: pChar); 
procedure GetWindowClass(var AWndClass : tWndClass); virtual; 
procedure SetUpWindow; virtual; 


{ Window Message Methods } 

procedure wmSysCommand(var Msg:tMessage); virtual wm_First + wm_SysCommand; 
procedure wmQuery0pen(var Msg:tMessage); virtual wm First + wm QueryOpen; 

{ Private Routines } 
procedure ToggleConfirm; 
procedure SetConfirmState; 
procedure Quit; 
end; 


{. 

{ tByeWin 

{. 

constructor tByeWin.Init(AParent: pWindowsObject; ATitle: PChar); 

- 1 

1 

- ) 

{ Construct the tByeWin's object. } 


begin 

Confirm := FALSE; { Defaults to No Confirm } 
tWindow.Init(AParent, Atitle); 

Attr.Style := ws_0verlapped OR ws_MinimizeBox OR ws_SysMenu 
end; 


1. 

procedure tByeWin.GetWindowClass(var AWndClass : TWndClass); 
begin 

tWindow.GetWindowClass(AWndCl ass); 

AWndClass.hlcon := LoadIcon(hInstance, 'ICON') { Assign the icon ) 
end; 

- } 

{. 

procedure tByeWin.SetUpWindow; 
var SysMenu : hMenu; 

Buffer : Array[0..1] of char; 

- } 
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Listing 2 — Cont’d 

begin 

SysMenu := GetSystemMenu(hWindow, FALSE); 

{ Add Items to the System Menu ) 

AppendMenu(SysMenu, mf_SysMenu + mf_Separator, 0, NIL); 

AppendMenu(SysMenu, mf_SysMenu, idm_Quit, 1 &Exit Windows'); 

AppendMenu(SysMenu, mf_SysMenu, idm_Confirm, 'Confirm AShutdown'); 

AppendMenu(SysMenu, mf_SysMenu, idm_0S, '&Operating System'); 

AppendMenu(SysMenu, mf_SysMenu, idm_About, 'SAbout Bye...'); 

( Now get the state of the Confirm Option - This is in WIN.INI } 
GetProfiIeString(IniAppName, 'Confirm', 'N', Buffer, sizeof(Buffer)); 
if Buffer[0] * 'Y' then 
ToggleConfirm 

end; 

{.) 

procedure tByeWin.wmSysComnand(var Msg:tMessage); 

( Handle the System Menu Items that were installed } 

var About: pDialog; 
begin 

case Msg.wParam of 
idm_About : begin 

New(About, Init(@Self, 'AboutBox')); 

Appl i cati on''. ExecDi al og (About); 
end; 

idm_Confirm: ToggleConfirm; 
idm_0S : WinExec('Command.Com', sw_Normal); 

idm_Quit : Quit 

else 

DefWndProc(Msg) 

end 

end; 


Listing 2 (bye2.pas) is written using OWL The binary 
resource file for this listing (bye2. res) is on the code disk. As 
you see it is still necessary to register your window class, but 
this is done in a virtual method, and if not done, would 
default to the class TurboWindow. There is no explicit message 
handling loop. For each message to be handled bythe object, 
you define a message-response method, or Dynamic Method. 
Dynamic Methods are an extension to virtual methods in that 
they are indexed by message number and executed when the 
message number is sent by Windows. Very little code is as¬ 
sociated with the About Dialog-, this is because OWL has 
"taught” pDialogs how to handle their controls. 

Remember that, while OWL provides a high-level way to 
write an application, you can write very efficient applications 
without it Although bye2 is slightly smaller than byel at the 
source code level, when compiled bye2 results in an .exe file 
four times larger than byel 's (17.1K vs. 4.3K). It also consumes 
about four times as much memory (35K vs 9K). For many 
handy desktop accessories that you want to keep at your 
mouse's reach, using the generic API makes sense because it 
keeps them as small as possible. 

Many programs, including Turbo Pascal for Windows, were 
written without the benefit of OWL (in fact, before OWL ex¬ 
isted). Just as assembly language programming did not vanish 
with the arrival of High Level Languages, writing applications 
with the generic API shouldn't vanish either. Each tool, and 
each methodology, has its place in application building. Being 
proficient in both can give your programs an edge. □ 
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vimoge aC'leno.tif'); 

//remove face from image 
vimoge b= a.cut(256,200,384,328) 
//magnify by interpolation 
vimoge c=b.interpolate(512,512); 
//write out to HP print file 
chp_screen(200,200,300,"out.hp"); 


HP Printing + Convolution + Remap + Resize + Cut + 

Copy + Paste + Color + Super VGA + Operator Overloads 
+ PCX/TIFF + Rotate + More! (Over 70 functions) 

CALL NOW FOR FREE BROCHURE! 

SOURCE $349 - LIBRARY $229 - 30 DAY GAURANTEE ■ VISA ■ MASTERCARD 
For BORLAND Ctt 

ImgingObjects 

1 - 8 0 0 • 2 5 3 • 1 8 0 4 or 1-7 1 6 - 6 7 1 - 7 9 9 8 

□ Request 147 on Reader Service Card □ 

Windows/DOS Developer’s Journal - Page 49 






Listing 2 — Cont’d 

{.-.} 

Procedure tByeWin.wmQueryOpen(var Msg:tMessage); 
begin 

Msg.Result := 0; { If this returns 0 then we cannot restore our window } 

Quit 

end; 

(.} 

Procedure tByeWin.Quit; 
begin 

if Confirm then 
begin 

MessageBeep(O); 

if MessageBox(hWindow, 'Are you sure you want to exit Windows? 1 , 'Exit Windows?', 
mb_IconQuestion + mb_OkCancel) = id_Cancel then 

EXIT 

end; 

SetConfirmState; { Write our Confirm=Y/N entry in WIN.INI } 

ExitWindows(0, 0) { See 'ya } 

end; 

{.-.} 

Procedure tByeWin.ToggleConfirm; 
var SysMenu : hMenu; 
begin 

SysMenu := GetSystemMenu(hWindow, FALSE); 

Confirm := NOT Confirm; 
if Confirm then 

CheckMenuItem(SysMenu, idm_Confirm, mf_byCommand+mf_Checked) 
else 

CheckMenuItem(SysMenu, idm_Confirm, mf_byCoirmand+mf_UnChecked) 

end; 

{.) 

Procedure tByeWi n.SetConfirmState; 

{ Sets the [BYE] 

Confirm=Y/N 
WIN.INI setting ) 
var Buffer: Array[0..1] of char; 
begin 

if Confirm then Buffer[0] := 'Y' 
else 

Buffer[0] := 'N'; 

Buffer[l] := #0; { Null terminate the String ) 

WriteProfileString(IniAppName, 'Confirm', Buffer) 
end; 


(.) 

{ tWExitApp ) 

(..) 


procedure tWExitApp.InitMainWindow; 

{ Construct the TWExitApp's MainWindow object: A tByeWin ) 
begin 

MainWindow := NewfpByeWin, Init(nil, AppName)) 
end; 

{ —-.} 

var WExitApp: tWExitApp; 
begin 

WExitApp.Init(AppName); 

ShowWindow(WExitApp.MainWindow^.hWindow, sw_ShowMinimized); { Minimize Window ) 
WExitApp.Run; 

WExitApp.Done 
end. 

{ End of File } 
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Detecting The Display Hardware 


Jonathan Wood 



Jonathan Wood develops software and does 
consulting work for his own company, SoftCircuits. 
Having a background in art and music, he enjoys 
designing user interfaces and video libraries. He 
welcomes your comments and questions and can 
be reached at SoftCircuits, P.O. Box 16262, Irvine, 
CA 92713. 


Most programmers want their programs to be used by as many people as possible. 
This entails writing programs that will run on as many computers as possible. Does it 
also mean programs should avoid writing directly to display memory to speed video 
output, for fear of writing to the wrong address? What about systems that can display 
more than 25 rows of text? To answer these questions, you need a reliable way to 
determine the type of display adapter installed. 

This article covers only text-mode programs. For example, the code presented does 
not make any attempt to determine if a monochrome display adapter is actually a 
Flercules graphics card. Most compilers supply fairly sophisticated (and bulky) video 
detection routines. You should use those routines if you need information for graphics 
programming. This article presents a reliable method for determining the segment ad¬ 
dress of display memory, a code that describes the active display adapter, whether or 

not the display adapter supports color, the cur¬ 
rent video mode, the current display page, the 
number of text rows, and the number of text 
columns. 


Using ROM BIOS Interrupts 

I have seen a variety of methods used to 
determine the display type, many of which in¬ 
volve reading and writing to ports and video 
registers. Not only are such methods more com¬ 
plex, they may, in fact, be undesirable, since 
more computers are compatible at the interrupt 
level than at the hardware level. 
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Listing 1 (initvid.asm) 


INITVID.ASM, Written Sept 1991 by Jonathan Wood, SoftCircuits 

Routines to determine host display adapter. Assembled using MASH 6.0. 
To assemble for different C memory models, modify the .MODEL 


directive to the correct model and recompile. To interface with other 
languages, change the language specifier on the same line. Depending 
on the language, you may need to modify the way parameters are 


; accessed and which registers are 

saved. 

» 

•MODEL 

small 

C 

[Specify memory model/language 

MONO SEG 

EQU 

OBOOOh 

;Standard display segments 

C0L0R_SEG 

EQU 

0B800h 


• DATA 

video segment 

DW 

COLOR SEG 

;Display memory segment address 

video type 

DB 

OFFh 

[Display combination code 

video iscolor 

DB 

Olh 

;1 = color, 0 = mono 

video mode 

DB 

03h 

[Video display mode 

video page 

DB 

OOh 

[Video display page 

video rows 

DB 

25h 

[Number of text rows 

video cols 

DB 

80h 

[Number of text columns 


• CODE 


Determines the active display adapter and various display parameters. 
Prototype: void initvideo(void); 


initvideo 

PROC USES si di bp 


mov 

ah,OFh 

[Read video information 

int 

lOh 


mov 

video mode.al 

[Video display mode 

mov 

video page.bh 

[Video display page 

mov 

video cols,ah 

[Number of text columns 

mov 

video segment.MONO 

SEG [Assume mono display for now 

mov 

video iscolor,0 


int 

llh 

[Read equipment list 

and 

al,00110000b 

[Isolate video bits 

cmp 

al,00110000b 

[Was it mono? 

je 

find adapter 

[Yes 

mov 

video segment,COLOR 

SEG [Else set color display 

mov 

video iscolor,1 


find adapter: 



call 

ps2 state 

[Read PS/2 video state 

jnz 

adapter set 

[Done if supported 

cal 1 

ega state 

[Read EGA video state 

jnz 

adapter Set 

[Done if supported 

call 

cga state 

[Determine CGA or MDA 

adapter set: 



sub 

ax, ax 

[Adjust display segment for 

mov 

es,ax 

; current video page 

mov 

ax,es:[044Eh] 


mov 

cl ,4 


shr 

ax,cl 


add 

video segment,ax 


ret 



initvideo 

ENDP 


This procedure attempts to access 

PS/2 compatible ROM BIOS video [ 

services. The 

zero flag is set if they aren't supported. ; 

Output: 

zf Zero flag set if PS/2 compatible ROM BIOS is ; 


not present 


ps2 state 

PROC NEAR 


mov 

ax,lA00h 

[Read PS/2 display code 

int 

lOh 


cmp 

al ,lAh 

[Was function supported? 

lahf 


[Toggle zero flag (zf = 1 if 


In addition, since many newer dis¬ 
play adapters can emulate several dif¬ 
ferent display types, snooping around at 
the hardware level may turn up con¬ 
flicting information. If I set my VGA for 
monochrome emulation and load the 
Microsoft QuickC editor, the screen goes 
blank. Microsoft probably has some of 
the most sophisticated video detection 
routines available, but they dig up so 
much information that they cannot pos¬ 
sibly be compatible with all adapters. 
When your goal is maximum com¬ 
patibility, you should obtain information 
through the ROM BIOS interrupts when¬ 
ever possible. 

Color Vs. Black And White 

The video detection method this ar¬ 
ticle presents is, for the most part, com¬ 
patible with IBM's suggested method, 
although the method described in the 
IBM Personal System/2 and Personal 
Computer BIOS Interface Technical Refer¬ 
ence is not very complete. The main 
problem with obtaining display informa¬ 
tion through ROM BIOS interrupts is that 
older systems do not support the ROM 
BIOS services required to get informa¬ 
tion on the newer display systems. 

The first step in determining the dis¬ 
play type is to use interrupt lOh (flH = 
OFh). This service returns the current 
video mode, display page, and the 
number of text columns. All IBM-com¬ 
patible PCs support this service. 

Next, issue an interrupt llh, which 
will return the word value at 
0040:0010. Each bit of this value 
provides information about the devices 
attached to the system. Bits four and 
five indicate what IBM documentation 
refers to as the “initial video mode." A 
monochrome adapter is present when 
both bits are on. If only one of the bits 
is set, the video adapter is a color 
adapter in either 80- or 40-column 
mode, depending on which bit is on. 
Obviously, this interrupt service was 
designed back when there were far 
fewer types of display adapters. For¬ 
tunately, all the newer systems I have 
ever tested are compatible with this in¬ 
terrupt, which I have found to be very 
reliable. 

I worked with one VGA system that 
was made to emulate monochrome 
simply by changing the video mode to 
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Listing 1 — Cont’d 


xor 

sahf 

ah,01000000b 

; al is not equal to lAh) 

jz 

no_ps2 

;PS/2 BIOS not present 

mov 

video type.bl 

;Save active display code 

mov 

ax,1130h 

;Read font code 

sub 

bh.bh 

;Font code (not used) 

int 

lOh 


inc 

dl 

;Adjust row count (clears zf) 

mov 

no_ps2: 

ret 

video_rows,dl 

; and save 

ps2_state 

ENDP 



“» 

If PS/2 compatible ROM BIOS is not present, this procedure attempts 


; to access the 

EGA ROM 

BIO 

video services. 


; Output: 

zf 

Zero flag set 

if EGA not active 


ega state 

PROC 

NEA 

* 


mov 

ah,12h 



;Read EGA video state 

mov 

bl,10h 




int 

lOh 




cmp 

bl,10h 



;Was function supported? 

je 

no ega 



;No, EGA BIOS not present 

cmp 

video iscol 

jr,bh 

;Is EGA the active display 

je 

no ega 



;No, find active display 

add 

bh,4 



;Else calculate display code 

mov 

video type. 

bh 

; and save 

mov 

ax,1130h 


;Read font code 

sub 

bh.bh 



;Font code (not used) 

int 

lOh 




inc 

dl 



;Adjust row count (clears zf) 

mov 

video rows, 

dl 

; and save 

no ega: 





ret 





ega_state 

ENDP 




; This procedure is called 

f neither PS/2 or EGA comaptible ROM BIOS 



was active. It simply assumes 25 text rows and sets video_type to MDA 
or CGA depending on the value of video_iscolor. 


cqa state 

PROC NEAR 


mov 

video rows,25 

;If we get here, must be 25 rows 

mov 

video type.Olh 

;Assume MDA display adapter for n 

cmp 

video iscolor.O 

;Is it mono? 

je 

no ega 

lYes 

mov 

no_cga: 

ret 

video type,02h 

;Else set CGA display adapter 

cga_state 

ENDP 


; This routine 

fills a buffer with the 

current video parameter values. 

; Note: initvideo() must be called first in order for this procedure to 

; return meaningful values. 


; Usage: 

void getvconfig(struct 

video *); 

; Where: 

struct video ( 



int segment: 



int type; 



int iscolor; 



int mode; 



int page; 



int rows; 



int columns; 

1; 


getvconfig 

PROC USES si di, buffer:PTR 


cld 

IF ODataSize 



1 00°/o ASSEMBLY 
FAST & COMPACT 

'P 

More than 600 easy-to-use routines 
hand coded in assembly language. Scroll¬ 
ing data entry screens, data entry forms, 
pick lists, pulldown menus, overlapping 
and moveable windows. Command line 
and file name parsing. Ctrl-C handling, 
numeric conversions, date/time func¬ 
tions, sound and more. 

Supports any text mode screen size, 
mouse, DOS extenders and memory 
managers. Great for TSR’s. 

Two windowing systems. One full fea¬ 
tured system (mouse support, drop shad¬ 
ows, several border types, etc.) and a 
new compact system. (Full system: 4- 
6K, compact system: 1.5-2K) 

• no cryptic macros 

• no royalties 

• free tech support 

• 30-day money back guarantee 


QUANTASM POWER LIB 

$99.95 

with source code 

$299.95 

other products: 


ASMFLOW Professional 

$199.95 

Magic TSR Toolkit 

$199.95 

Floating Point Library 

$99.95 



19855 Stevens Creek Blvd, Suite 154 
Cupertino, CA 95014 


To order or get more info call 
408 244-6826(Voice & Fax) 

800-765-8086 
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mode 7 (the default monochrome text 
mode). In mode 7, display memory was 
at the default monochrome address 
and the adapter did not display color. 
While in this mode, the system 
reported itself as a color VGA, but inter¬ 
rupt llh indicated black and white. At 
the time, my video detection routines 
relied on the fact that the system was 
a color VGA to determine the location 
of video memory and whether the sys¬ 
tem was color. The routines did not 
work for the monochrome emulation. 
By modifying them to use interrupt llh 
to determine the display address and 
color support, the routines became 
more compatible with sophisticated 
adapter cards that can emulate other 
systems. So, when interrupt llh returns 
both bits four and five set, you should 
set the display segment to 
monochrome memory ( OBOOOh) and 
consider the adapter black and white. 
Otherwise, set the display segment for 
color memory ( OBSOOh) and assume the 
adapter is color. 

I should point out that composite 
monitors are black and white displays 
connected to a Color Graphic Adapter. 


Notice to Our 
Subscribers 

Occasionally, Windows/DOS 
Developer’s Journal makes its 
mailing list available to vendors 
of products we think our readers 
will find interesting. Current sub¬ 
scribers receive free information 
in the mail from these vendors. 

If you prefer that your name 
not be used in these mailings, 
please let us know. Just copy or 
clip this form and send it with 
your name and address to: 

Windows/DOS 

D DEVELOPER'S JOURNAL 

Windows/DOS Developer’s Journal 
1601 W. 23rd. St, Ste. 200 
P.O. Box 3127 
Lawrence, KS 66046-0127 


These systems are an exception to the 
previous discussion. Composite monitors 
work exactly like color monitors except 
that they don't display color. Since com¬ 
posite monitors behave like color 
monitors in every other respect, a color 
adapter will not know that it is con¬ 
nected to one. In order to support 
these systems, users should be able to 
force programs to use color attributes 
suitable for non-color systems regard¬ 
less of what type of display the pro¬ 
gram finds active. Microsoft QuickCs /b 
option is an example. 

The Adapter Type 

After deciding whether the display is 
color or black and white, you have to 
resort to ROM BIOS services that not all 
PCs support. Using carefully selected 
ROM BIOS calls, you can determine the 


correct display type by a process of 
elimination. 

If a PS/2-compatible ROM BIOS 
(which includes MCGA and VGA display 
adapters) is present, interrupt lOh ifiH = 
lAh) returns a display code that indi¬ 
cates the type of display adapter cur¬ 
rently active. Since this function returns 
with AL set to lAh, you can determine 
whether the BIOS supports this service, 
by setting the AL register to zero before 
issuing the interrupt. If it is supported, 
the interrupt returns the display com¬ 
bination code in the BL register. You 
can then get the number of screen 
rows by issuing an interrupt lOh (fiH = 
llh, AL = 30h, BH = 00/7). This service 
returns the number of rows, minus one, 
in the DL register. 

If a PS/2-compatible ROM BIOS is not 
present, you should test for the 


les 

di.buffer 

Listing 1 — Cont’d 

;Load far struct pointer into es:di 

ELSE 

mov 

di.buffer 

;Load near struct pointer into es:di 

push 

ds 


pop 

es 


ENDIF 

mov 

si,OFFSET video segment ;ds:si points to display variables 

1 odsw 


;Copy video segment to buffer 

stosw 

mov 

cx,6 

;Copy 6 more byte values 

sub 

ah,ah 

;Clear high byte of ax 

copy loop: 

lodsb 


•.Load byte value in al 

stosw 


;Copy word value to buffer 

loop 

copy loop 


ret 

getvconfig 

ENDP 


END 

; End of File 





Listing 2 (demo.c) 

linclude <stdio.h> 

#include <string.h> 

#include <dos.h> 


struct video { 
int segment; 
int type; 
int iscolor; 
int mode: 
int page; 
int rows; 
int cols; 

); 


void initvideo(void); 

void getvconfig(struct video * 

; 

/* 

** descriptors for each display code starting with code 00 
*/ 

char ‘types[j = ( 
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presence of an EGA. Interrupt lOh (flH = 
12h, BL = lOh) returns EGA information. 
If on return BL still equals lOh, an EGA is 
not present. Otherwise, an EGA is 
present. However, the EGA might not be 
the active display, so you have to check 
a little further. This function sets the BH 
register to zero if the EGA is color, or to 
one if the EGA is a monochrome. Since 
you have already determined whether 
the display is color or not, simply com¬ 
pare the earlier result with the BH 
register. If they disagree, then the EGA 
is not the active display; otherwise, it is. 
If the EGA is the active display, you can 
use the same method already 
described for PS/2-compatible ROM BIOS 
to determine the number of screen 
rows on the display. 

If the machine supports neither the 
EGA or PS/2-compatible ROM BIOS, the 
display must be a CGA or an MDA. Since 
you already know whether the system 
is color or not, you can determine 
which of these two adapters is active. 
Also, since these adapters support only 
25 rows of text, you can assume that 
this is the number of rows currently 
displayed. 

Some older CGAs snow (flicker white 
spots randomly) if a program writes to 
video RAM at the same time the video 
adapter is refreshing the screen. You 
can avoid this problem by writing to 
display memory only during video 
retrace. Techniques for doing this have 
been well documented so 1 won’t dis¬ 
cuss them here. Snow is not a problem 
on any other adapter (including newer 
CGAs). If your program deals with CGA 
snow, it should do so only if a CGA is 
the active display adapter. Your 
programs should also allow the user to 
disable this feature since writing to the 
screen only during video retrace slows 
display output noticeably. 

Finally, if the display page was non¬ 
zero, the active portion of display 
memory does not start at the beginning 
of the display segment. The word value 
at 0040:004E contains the current offset 
into the display segment. While you 
could add this value to the offset por¬ 
tion of the screen address each time 
you calculate a new screen location, it 


is simpler to convert the offset to its 
segment equivalent and add it to the 
display segment. Note that this is the 
only place it was necessary to obtain 
information directly from the ROM BIOS 
data area and not through interrupts. 

The Code 

Listing 1 presents initvideof) and 
getvconfigf) . You should first call in- 
itvideo() to determine the display 
type. Then, call getvconfigf) with a 
pointer to a structure of type video. 
The information obtained by init- 
videof) will be copied into the struc¬ 
ture. I assembled this file using MASM 
6.0. The code should work with any 
memory model by modifying the 
.MODEL directive and recompiling. You 
could make the code work with other 
languages by changing the language 
specifier on the same line, although 
some languages may require other 
changes to the code. Listing 2 presents 
a C program to test the routines in List¬ 
ing 1. 

Conclusion 

It has always irritated me to run a 
program that doesn’t take advantage of 
my color display or that writes only to 
the top half of my screen when my 
screen displays 50 rows. By using the 
techniques described here, your 
programs can reliably determine video 
display parameters and act accordingly. □ 
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Universal 
Printer 
Driver 

Would Text and Graphic 
Printer support for over 
750 Printers (including 
PostScript) give you a 
competitive edge? 

By including SLATE, you can print 
both Text and Graphics on over 750 
printers (including PostScript, 
LaserJet III and the new Epson 
scalable font printers). 
Immediately! Painlessly! 

You can use SLATE in your product 
with no royalties. 

SLATE gets you out of the printer 
support business. Forever! 

Make your product more functional 
and competitive by using SLATE'S 
advanced text features: 

• Support multiple printers on the same 

system. 

• Output to parallel printers, serial printers, 

DOS files/devices, DOS print spooler, 
and Novell network printers. 

• Include end user's soft fonts. 

• Support cartridge fonts. 

• Support proportional fonts 

• Support scalable font printers. 

• Set exact print positions. 

• Color printing 

• Kerning, leading, overstrike, underlining, 

and strike through. 

• Automatic character set conversion. 

SLATE with Graphics adds advanced 
graphic printing features: 

• Print images from the screen, PCX or TIFF 

files, or custom image systems. 

• Scale and Rotate the printed image. 

• Print grey scale and color images. 

• Intermix text and graphics. 

SLATE is a set of C or Basic libraries 
with over 170 text printing functions, 

a Database of over 750 printers, 
and End User configuration and 
testing programs. 

SLATE with Graphics adds over 60 
graphic printing functions. 

Call now for a complete developer's 
information kit. Order SLATE for 
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for $448 with our risk free, 30 day 
return policy. 
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THE Audio Solution . 



Looking for 
a Standard 
for 

Digitized PC 
Sound? 

THE Audio 

for 

Digitized PC 
Sound! 


With DigPak's single, 
standard API you can 
easily support all 

leading PC sound 
boards with no more 
effort than that re¬ 
quired for one. Dig¬ 
Pak's loadable driver 
approach uses simple 
calls through a 

software interrupt or 
LINKable interface. 
And using our 

ACOMP compression 
utility you can achieve 
up to 6-to-l compres¬ 
sion on voice data! 


sound blaster covox adlib 
digispeech lantastic 
disney sound source 
IBM internal echo II 
pro audio spectrum 


THE Audio Solution, Inc. 
314 - 567-0267 
We sell FatClips too! 


Listing 2 — Cont’d 


"[00] No display", 

“[01] Monochrome Display Adapter (MDA) w/mono display", 

"[02] Color Graphics Adapter (CGA) w/color display", 

"[03] <reserved>", 

"[04] Enhanced Graphics Adapter (EGA) w/color display", 

"[05] Enhanced Graphics Adapter (EGA) w/mono display", 

“[06] Professional Graphics System (PGS) w/color display", 

"[07] Video Graphics Array (VGA) w/analog mono display", 

"[08] Video Graphics Array (VGA) w/analog color display", 

"[09] <reserved>", 

"[10] <reserved>", 

"[11] Multi-Color Graphics Array (MCGA) w/analog mono display", 
"[12] Multi-Color Graphics Array (MCGA) w/analog color display", 
“Unknown display combination code". 


struct video v; 
int color = 0x07; 

/* 

** writes a string at the specified location 
** by writing directly to video memory 
*/ 

void vwrite(char *str,int row,int col,int color) 

{ 

char far ‘screen; 

FP_SEG(screen) = v.segment; 

FP_0FF(screen) * (((row - 1) * v.cols) + (col - 1)) * 2; 

while(*str) ( 

*screen++ ■ *str++; 

*screen++ * (char)color; 

) 

} /* vwrite */ 

void main(int argc, char *argv[]) 

( 

int blkwht 1 0; 
char buffer[81]; 

/* force black and white if /b option was given */ 
if(argc) 

if(!stricmp(argv[l],"/B")) 
blkwht - 1; 


/* detect host display type */ 
initvideo(); 

/* fill our video data structure */ 
getvconfig(iv); 

if(v.iscolor && Iblkwht) 
color = OxlF; 


/* print out values */ 

sprintf(buffer,"v.segment : %04X",v.segment); 
vwrite(buffer,3,1,col or); 
sprintf(buffer,"v.type : %s", 

(v.type >* 0 && v.type <= 13) ? types[v.type] 
vwrite(buffer,4,1,color); 


types[13]); 


sprintf(buffer,"v.iscolor 
vwrite(buffer,5,1,color); 
sprintf(buffer,"v.mode 
vwritefbuffer,6,1,color); 
sprintf(buffer,"v.page 
vwritefbuffer,7,1,color); 
sprintf(buffer,“v.rows 
vwrite(buffer,8,1,col or); 
sprintf(buffer,“v.cols 
vwrite(buffer,9,1,color); 


%d",v.iscolor); 
%d",v.mode); 
%d",v.page); 
%d",v.rows); 
Vd",v.cols); 


) /* main */ 


/* End of File */ 
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I Reader-Contributed Tricks And Hacks 57 

Tech Tips 



Edited by 
Leor Zolman 


Please send us your best 
tricks and hacks — those 
clever pieces of code to 
make things work the 
way they should! You'll 
receive at least $50 for 
each tip that we print 

Send your submissions to.- 
TECH Tips 
Leor Zolman 
2601 Iowa 
Lawrence, KS 66046 



How To Really Defeat Cali Waiting 


Dan Goldberg 
DEG Consulting 239 East 88, #1 
New York, N.Y. 10128 


If you have one phone line for both voice and data, and you have call waiting on 
that line as well, then I'm sure you’ve had calls to Bulletin Boards and other on-line 
services interrupted by call waiting. Usually the modem on the other end goes on- 
hook and your session is terminated. Introduction of the Zmodem protocol helped a 
lot because it allows you to re-initiate a file transfer right where you left off. That's 
powerful stuff, but it only treats the symptoms. 

I know there are many programs out there in the public domain that claim to 
defeat call waiting. But the programs I have tried have not worked - perhaps be¬ 
cause they were not designed with my particular modem and my particular phone 
line in mind. 

It makes a difference because different modems may have, by factory default or 
communication program setup-strings, different default values in their registers. And 
all phone lines are not created equal. For instance, a caller in Idaho might have to 
wait longer to detect a carrier signal than one in New York. 

I will assume that the reader knows what call waiting is for and how to use it. 
However, let me note, before going any further, that some phone companies allow 
you to temporarily suspend call waiting by pressing a phone-key combination before 
a call, then to re-invoke it by pressing another phone-key combination after the call. 
In New York City, according to 611 (repairs), you hit ‘70 to suspend call waiting, 
which is then automatically re-invoked when the call is Finished. This does not work 
for me. You'll have to call your phone company to find out if this service is offered 
in your area. If it is, and it actually works, just use that Otherwise, read on. 

Call waiting signals another incoming call with a .75 second beep. What you must 
do, then, is get your modem to ignore the call waiting loss-of-carrier for its .75 
second duration. Properly configuring the S9 and S10 registers will accomplish this. 


A long time ago, Leor Zolman wrote and distributed the BDS C Compiler for CP/M 
(what's that?). Following a several-year hiatus from computer-compulsiveness to learn 
some people skills, he got married, dragged his disbelieving wife to Kansas and joined 
the staff of R&D Publications, Inc Two years later his wife has almost forgiven him. 
You can reach him at leor@rdpub.com or uunet!bdsoft!rdpub!leor. 
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The 59 Register 

This register determines how long the carrier signal from 
the REMOTE modem must be present before the LOCAL 
modem (your modem) recognizes it as a carrier signal rather 
than just line noise/garbage. 

On alternate Tuesdays when the moon is full and stray 
neutrinos spin to the left, line noise may sound exactly like a 
carrier signal, but never for very long, hence the default 59 
value of 6 (or 6/lOths of a second). 

The S10 Register 

The S10 register determines how long the local modem 
will allow loss of carrier signal from the remote modem 
without going on-hook. The default value for the S10 register, 
in tenths-of-a-second, is 7. 

One might think that we need only increase the S10 
register’s loss-of-carrier toleration-time to .8 or 8/10ths of a 
second (.5 more than call waiting's .75/second tone). But no! 
We also need to increase the amount of time the remote 
carrier signal must be present before the local modem recog¬ 
nizes it, because the true carrier dropout time is not deter¬ 
mined by the S10 register alone. Rather, it is a formula: 

S10 - S9 = carrier dropout time window 

or, using default values: 

7 - 6 = 1 or l/10th of a second 


* Decoding Your Mailing Label * 


The numbers on your mailing label appear as: 

10000 #07.1 08.3 

The first number is your account number. The 
second set of numbers represents the issue you just 
received (in <volume>.<issue> format) and the third 
set represents the issue with which your subscription 
expires. The example was mailed to account number 
10,000, affixed to vol. 7, no. 1, and expires with vol. 8, 
no. 3. 

NOTE: If the last two sets of numbers match, 
this is the last issue of your subscription. To avoid 
missing any issues, contact us today. 

For any questions about your subscription call us 
at (913) 841-1631. Having your mailing label handy 
will speed up the transaction. Thanks! 

R&D Publications 

1601 W. 23rd. St., Ste. 200 
P.O. Box 3127 

Lawrence, KS 66046-0127 
(913) 841-1631 
FAX (913) 841-2624 


The defaults clearly do not allow enough time to “hold onto 
the carrier” and defeat call waiting. Instead, do your calcula¬ 
tions based on this (generalized) formula: 

Call Waiting Time + S9 + Safety Factor = S10 time value 

For example: 

8 + 6 + 5 = 19 

So, setting the S10 register to a value of 19 will create a suffi¬ 
cient time window for your modem to defeat call waiting. 
That is, 19 in the S10 register will permit the .75/second loss 
of carrier; the 6 in 59 allows ,6/second for the local modem to 
recognize the remote carrier; and a .55/second margin is left 
for error. 


Listing 1 (dcomm.c) 

/* 

* Purpose: to defeat call waiting by creating 

* the proper carrier loss/ 

* carrier detect (time) window. 

* 

* Usage: DC0MM <enter> 

★ 

* Dan Goldberg, Quick C v2.5, 10/91 

* 

* Compile (tested by LZ under Borland C++): 

* bcc -D_MSC dcomm.c 

*/ 

finclude <stdio.h> 
finclude <conio.h> 
linclude <bios.h> 

#define _MSC 

fdefine COMPORT 1 /* 0 for C0M1, 1 for COM2 */ 

void set_modem(char *setup_string) 

1 

while(*setup_string != 1 \0 1 ){ 
outp(0x03f8,*setup_string); 
printf("%c", *setup_string); 

*setup_string++; 

1 

1 


main() 

{ 

/* initialize serial port */ 
unsigned data; 

/* all constants (except COMPORT) defined in bios.h */ 
/* see bios.h for more information on _bios_serialcom */ 

data = (_C0M_CHR8 | _C0M_ST0P1 | _C0M_N0PARITY | 
_C0M_2400); 

_bios_serialcom( _C0M_INIT, COMPORT, data); 

/* call setmodem function for call-waiting 
/* defeat string */ 
set_modem("AT S10=19“); 

} /* end of program */ 

/* End of File */ 
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Remember, your area's phone lines and your modem may 
call for slightly different numbers, but the theory and formula 
are the same. 

The only downside is that if you get another call while 
using your modem you may see garbage on the screen, or a 
“bad block” may be sent or received in a file-transfer, but 
today's protocols do a great job in handling errors, as we all 
well know. 

So, to sum, go into your communications package and set 
your modem like so: 

AT S10=19 

To set the modem before entering your communications 
package, see the small C program in Listing 1. The program 
assumes your 59 register has a value of 6. You will note that 
this program could be modified to send any string to your 
modem. 

Reliable NEC V20 Detection 
(Compile Me With Turbo-C) 


Anthony V. Ingenoso 
Suite 274 
1323 s.E. 17th street 
Ft. Lauderdale, FL 33316 

This technique uses the fact that the NEC V20 behaves dif¬ 
ferently than Intel CPUs do when a mutant form of the AAD 
instruction is used. The AAM/AAD instructions are 2 bytes, 
where the second byte is actually a base that the instructions 
are to work with (normally decimal 10 for BCD operations). If a 
different base is specified, then the instructions will work in 
that base. For example, with a value of 16 they’ll work in hex. 



Listing 2 

linclude <stdio.h> 
linclude <dos.h> 

/* 

* Reliable NEC V20 detection 

* Written by Anthony V. Ingenoso 
*/ 

void main(void) 

( 

_BX = OxOOff; 

_AX = OxOOff; 

_emit_(0xd4, 16); /‘mutant AAM (splits nibbles 

in AL into OFOF in AX) */ 

_emit_(0xd5, 16); /* mutant AAD (glue nibbles back 

into 00FF in AX) */ 

if (_AX 1= _BX) 

puts("This is a V20 CPU\n“); 
else 

puts("This isn't a V20\n"); 

) 

/* End of File */ 


The V20 has a bug when dealing with the altered form of AAD 
and seems to have base 10 hard wired in regardless of the 
explicitly specified base. 

This technique is useful for other things too. The AAM 
variant can be used to do very space efficient conversion of 
hex values for printing since it splits the nibbles of the byte in 
AL cleanly, making the usual shifting/masking unnecessary. 
Since the AAD variant misbehaves on V20's, it is not real use¬ 
ful - unless you KNOW your code is only going to be run on 
non-V20 CPUs! 

Listing 2 shows a small C program that performs the V20 
detection test 

Back in the days of CP/M and my BDS C compiler, I 
used a similar hack to test for the presence of Zilog’s ZBO 
chip. If I recall, the Carry flag reacted differently after a 
simple register increment instruction on the ZBO than it did 
after the same increment instruction on an 8080. The only 
way BDS C ever took advantage of a Z80, however, was to 
use the block move instructions during compilation! That 
made a big difference, because BDS C shuffled stuff around 
in memory a lot End of historical note for the month... -IzD 


Liana 

Interpretive C-like 
Object-Oriented Programming 
Language and Class Library 
for Windows 3 

□ Great for casual programming, prototyping 

□ Syntax of C++ simplified and extended 

□ Faster and less error-prone coding 

□ Automatic memory management 

□ Simplified string manipulation 

□ Flexibility of an interpreter 

□ Better run-time error detection 

□ High level class library 

□ DDE and DLL support 

□ Low cost Personal Developer: $129 

□ Royalty-free Professional Developer: $495 

Base Technology 1543 Pine St., Boulder, CO 80302 
800-786-9505 303-440-4558 CompuServe [70642,2662] 
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Call For Papers 


Windows/DOS Developer’s Journal is seek¬ 
ing articles on the topics below. If you have an 
idea for a related story and experience that 
would especially qualify you to write on one of 
these topics, contact the Wlndows/DOS 
Developer’s Journal editorial staff for Author 
Guidelines at: 


Wlndows/DOS Developer’s Journal 

1601 W. 23rd St., Suite 200 
P.O. Box 3127 
Lawrence, KS 66046-0127 
(913) 841-1631 
FAX (913) 841-2624 


TOPICS 


Interpreters 

■ Proposals due 1/6/92 
manuscripts due 2/10/92 

Suggested topics: Generating 
threaded code for a PC inter¬ 
preter. An interpreter replace¬ 
ment for C0MMAND.COM. A minimal 
8086 Forth interpreter. A DOS 
shell for Windows. A feature 
comparison of Smalltalk, Actor, 
Liana, Object/1, KnowlegePro, 
etc. A User Report on a PC im¬ 
plementation of MUMPS. 


Debugging 

■ Proposals due 2/6/92 
manuscripts due 3/12/92 

Suggested topics: Using 

hardware debuggers. ossert()- 
style macros for Windows. Using 
protected-mode to catch stray 
pointers. Debugging NLM ap¬ 
plications. 


Efficiency 

■ Proposals due 3/5/92 
manuscripts due 4/10/92 

Suggested topics: How to use 

the Windows GDI efficiently. 
Using the UART FIFO queue for 
efficient serial data transfer. Run¬ 
time detection and utilization of 
286/386/486 features. An efficient 
subsegment memory allocator 
for Windows. Tuning network I/O 
for maximum throughput. 


We prefer very practical and detailed treatments of 
real problems encountered when working on PC 
platforms. Topics should be of practical interest to 
professional developers working under MS-DOS or 
OS/2. Accompanying code may be in BASIC, Pas¬ 
cal, C, assembly, C+ + , or another language if the 
nature of the story requires it. 


We pay at rates competitive with other national 
technical journals and provide better editorial assis¬ 
tance than most. 

Proposals should include a short abstract, a one- 
page outline, and a brief resume of the author’s 
qualifications. When mailing the proposal, please 
include a hard copy and an ASCII text file on an 
MS-DOS formatted disk. 
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■ Developer's Preview 6i 


Foreign Language Pre-Processor 
And String Externalization Tools 


Ron Burk 


Probably the biggest job you face in 
internationalizing software is getting the 
strings out. Every string constant in 
your program is a candidate for transla¬ 
tion to the target language. You do not 
want to ship a product, for example, 
with beautiful German menus and help 
messages that emits an English error 
message when it runs out of memory. 
This article examines two software 
packages from Network Dynamics 
designed to eliminate the drudgery of 
getting the strings out of C programs. 

One approach to handling string con¬ 
stants is to store them in a separate file 
and load them into your program when 
it starts up. This allows you to hand the 
string file to a translating service 
without their having to understand your 
programming language and your having 
to worry that they will introduce 
programming errors. As a side benefit, 
loading the strings at startup is useful if 
you want to allow the user to select 
the language from the command line 
(some countries are more bilingual than 
the United States). Another side benefit 
for DOS programs is that loading the 
strings dynamically can free up precious 
space in the default data segment. 

String Externalization Tools 

The String Externalization Tools pack¬ 
age consists of two parts: a program for 
extracting strings from C programs and 


library routines for loading in the strings 
at startup. 

To extract strings from your source 
files, you use the supplied bextstr.exe-. 

bextstr <input.c >output.c 

Figure 1 shows the effect of using this 
utility on a C source file. The important 
thing to note is bextstr encloses the 
string constant in the input file inside 
the macro EXT_STR(), whose default 
definition is: 

Idefine EXT_STR(a,b) (*(ext_str+a-2)) 

Note that this macro ignores its second 
argument, which is the original string 
constant This simple trick is invaluable, 
since you can see the original string 
constant in your code, even after you 
have moved all the string data to an 
external file. Without those string con¬ 
stants, the code becomes much less 
readable as, for example, you try to 
remember what message number 124 
says. 

bextstr also generates a header file 
(ext.h) that contains this macro defini¬ 
tion and the declaration for ext_str, 
the array of string pointers. You have to 
include this header file in each C source 
file that contains a string constant The 
package includes a library function, 
init_external_strings (), that loads 
in the file of strings and initializes 


ext_str to be an array of pointers to 
them. You have to modify your code to 
call this function before referencing any 
of the externalized strings. 

Limitations 

One of the main reasons to use 
bextstr is to avoid having to edit each 
and every string constant yourself. The 
utility does not handle all possible 
situations though, so it is worthwhile to 
look at how much work you could be 
left with. 


Product Information 

■ Product- 

String Externalization Tools 

■ Price: $149.95 
($249.95 with source) 

■ Product: Foreign Language 
Pre-Processor 

■ Price: $349.95 

Network Dynamics, Inc. 

2225 South Henry Street, Suite L-2 
Williamsburg, VA 23185 USA 
(804) 220-8771 
FAX (804) 220-5741 


Ron Burk has a B.S.E.E. from the University of Kansas and has been a programmer for the past 10 years. You may contact him 
at Burk Labs, P.O. Box 3082, Redmond, WA 98073-3082. CIS: 70302,2566. 









If replacing a string constant with the dynamic expression 
referencing ext_str produces a syntax error, you have a 
problem. Probably the most common case is in aggregate 
(array and structure) initialization. For example, when bexstr 
reads 

char *a[5] = "abed"; 

it produces the following illegal code: 

char *a[5] = (*(ext_str+l)); 


Correctly detecting these cases would require bextstr to be 
nearly as smart (and as large and slow) as a C compiler. In 
most cases (for example, all static initializations), you will have 
to rewrite the code anyway if you want to initialize the vari¬ 
able from an externally loaded string. 

The previous example points out a general problem: fixed 
string buffer sizes. The foreign translation of a phrase may 
well require more characters than the English version. Inde¬ 
pendent of whether you use an automatic tool like this or 
not, you must avoid fixed-size static declarations for string 
data that you want to internationalize. The best solution is to 


Listing 1 (winext.c) 

♦include <stdio.h> 


♦include <stdlib.h> 

while((TotalLines>0) && fgets(InputLine, 


MAX LINE, InputFile)) 

/* Biggest line we can handle */ 

I 

♦define MAX LINE (1024*1) 

—Total Lines; 


if(strlen(InputLine)) 

typedef unsigned long ULONG; 

InputLine[strlen(InputLine)-l] * ' \0 ' ; 

FILE *0penFile(char ‘FileName, char *0penMode) 

/* LineCount+1 because bexstr starts numbering 

( 

* at 2 for some reason. */ 

FILE ‘File * fopen(FileName, OpenMode); 

fprintf(OutputFile, "\t%lu\t\"", ++LineCount+l); 

if (File == NULL) 

CharCount +■ ConvertLine(OutputFile, InputLine); 

( 

fputs(“\"\n“, OutputFile); 

fprintf(stderr, “Can't open file ' %s 1 for '%s'\n“. 

) 

FileName, OpenMode); 

if(TotalLines != 0) 

exit(EXIT FAILURE); 

( 

} 

fprintf(stderr, "Error: 

else 

string file delivered %lu less lines than delivered\n“. 

return File; 

TotalLines); 

} 

exit(EXIT FAILURE); 

\ ~ 

ULONG GetLineCount(FILE ‘InputFile, char ‘InputLine) 

i 

return CharCount; 

\ 

1 

if(fgets(InputLine, MAX LINE, InputFi1e) ) 


return atol(InputLine); 


else 

int main(int arge, char “argv) 

/ 

l 

fprintf(stderr, "Input file is empty\n M ); 

FILE ‘InputFile, ‘OutputFile, *CountFile; 

exit(EXIT FAILURE); 

char *InputLine = (char *)malloc(MAX LINE); 

) 

ULONG TotalLines, Total Chars; 

} 

if(InputLine *■ NULL) 

size t ConvertLine(FILE ‘OutputFile, char ‘InputLine) 

( 

I 

fprintf(stderr, "Can't allocate %ul bytes\n", MAX LINE); 

size t LineLength = 0; 

exit(EXIT FAILURE); 

char C; 

) 


InputFile ■ 0penFile("ext.str", "r"); 

for(; (C=‘InputLine++); ++LineLength) 

OutputFile * 0penFile(“ext.rc", "w"); 

if(C - -W) 

CountFile * 0penFile(“extcnt.h", "w"); 

switch(C = *InputLine++) 

TotalLines “ GetLineCount(InputFile, InputLine); 

( 

fprintf(stdout, “Processing %lu lines\n“, TotalLines); 

/* RC chokes on */ 

TotalChars = Convert(InputFi1e, OutputFile, 

case : 

InputLine, TotalLines); 

fputs("\\042“, OutputFile); 

fprintf(CountFile, "Idefine WINEXT LINES (%lu)\n", TotalLines); 

break; 

fprintf(CountFile, "#define WINEXT CHARS (%lu)\n M , TotalChars); 

default : 

fclose(InputFile); 

fputcCW, OutputFile); 

fdose(OutputFile); 

fputc(C, OutputFile); 

fclose(CountFile); 

1 

exit(EXIT SUCCESS); 

else 

1 

fputc(C, OutputFile); 



/* End of File */ 

return LineLength + 1; /* add one for end-of-string */ 

} 


ULONG Convert(FILE ‘InputFile, FILE *0utputFile, 


char ‘InputLine, ULONG Total Lines) 


I 

ULONG CharCount = 0; 


ULONG LineCount = 0; 


Program to Translate to . RC File Format 
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get into the habit of using dynamically allocated pointers 
whenever possible. 

A less forgivable flaw is bextstr' s inability to deal with 
two legal forms of string continuation, bextstr stumbles on 
both 

char *a = "a very, very..." 

"... very long string"; 

and 

char *a = "a very, very...\ 

... very long string"; 

In the first case, bextstr creates a syntax error because it 
does not correctly combine the two strings into one. In the 
second case, bextstr complains that strings should not cross 
line boundaries. 

I used bextstr on a Windows program containing about 
2,000 lines, bextstr correctly found all 38 strings in the three 
source files. Of the 38 strings, I had to fix three by hand. Two 
of these were aggregate initializations and one was a string 
continuation, bextstr automatirally handled more than 90 
percent of my strings and then the compiler pointed out the 
ones that required hand coding. 

Because of the traditional limitations of the 8086 seg¬ 
mented architecture, bextstr cannot handle more than 64Kb 
of string data. It also limits you to a total of 15,185 strings. 
Few PC C programs will exceed these limits, but if yours does, 
you can break the string file up into separate files. For ex¬ 
ample, you could have bextstr store strings in ext.str for 
half of your source files and ext2.str for the other half. You 
would then load two string files at startup instead of one. You 
can also use separate string files in order to save space by 
loading groups of strings only when the corresponding code 
executes and then freeing them when they are no longer 
needed. The largest permissible individual string is 1,000 char¬ 
acters (the Windows resource compiler only allows strings up 
to 255 characters). 

Special Features 

The basic task of locating quoted strings in a C source file 
is not too difficult. You could probably write the basic pro¬ 
gram in a few hours and eventually get all the bugs and spe¬ 
cial cases worked out over the course of a few weeks. The 
String Externalization Tools, however, supplies some 
functionality that would take considerably more time to dupli¬ 
cate. 

The package handles all of the possible string escape se¬ 
quences. For example, when the source file contains “\n", 
these two characters are translated into a linefeed character 
when the string i s loaded into memory. The package also 
allows you to set a flag to handle Kanji characters, without 
this flag, init_external_strings() might incorrectly mistake 
the second half of a double-byte character for a “\". 

bextstr automatically combines duplicate strings. For ex¬ 
ample, if source file foo.c contains “Enter date:” and source 
file fee.c contains “Enter date:”, bextstr only places one oc¬ 
currence of this string in the string file. You probably will see 


Listing 2 (extstr.h) 

fifndef EXT_INCLUDED 
#define EXT_INCLUDED 

findude "extent.h" /* defines total # of strings */ 

extern char **StringPointers; 

extern int LoadExternalStrings(unsigned int 

ResourceHandle); 

fdefine EXT_STR(a,b) (StringPointersfa]) 
fdefine N0_EXTERN(a) a 

#endif 

/* End of File */ 

String Header File for Windows 


less than a 10 percent reduction in string file size from this 
option, but it takes no extra effort on your part. Also, if you 
are paying a translating service to translate the string file, the 
smaller string file may cost a little less. You can use a com¬ 
mand line option to prevent duplicate string removal. 

The most important feature these tools offer over a more 
casual implementation is the ability to re-extract strings. After 
you use bextstr once, you will probably continue to enhance 
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your software and, in that process, introduce more string con¬ 
stants. You do not have to assign each new string constant a 
number and add it to the string file by hand. Instead, you can 
just run bextstr again when you are ready to update the 
external string file, bextstr will correctly handle previously 
externalized strings, new strings, deleted strings, and modified 
strings to produce a new string file. With this tool, string ex- 
ternalization can be a minor detail at the end of your 
development cycle instead of a constant obstacle while you 
are developing code and adding new strings. 


Listing 3 (extstr.c) 

#include <stdlib.h> 

♦include <limits.h> 

♦include <string.h> 

♦include <windows.h> 

♦include "extstr.h" 

char ""StringPointers; 

int LoadExternalStrings_(HANDLE ResourceFile); 

int LoadExternalStrings(HANDLE ResourceFile) 

{ 

char Message[256]; 

if(!LoadExternalStrings_(ResourceFi1e)) 

{ 

if(!LoadString(ResourceFile, 0, Message, 255)) 

strcpy(Message, "Can't load language strings!"); 
MessageBox(NULL, Message, NULL, MB_IC0NST0P); 
return 0; 

) 

else 

return 1; 

) 

int LoadExternalStrings_(HANDLE ResourceFile) 

{ 

char "StringBuffer; 

size_t Offset, Length, SpaceLeft, BufferSize; 
char "LoadPoint; 

StringPointers • (char **)malloc( 

sizeof(char*)*(l+WINEXT_LINES)); 

BufferSize • WINEXTCHARS; 

StringBuffer ■ (char *)malloc( 

sizeof(char)"Buffersize); 

LoadPoint * StringBuffer; 

SpaceLeft - BufferSize-1; 

for(0ffset = 1; Offset < WINEXTLINES; ""Offset) 

( 

if(SpaceLeft < 255) 

{ 

if((U1NT_MAX - 512) > BufferSize) 

{ 

BufferSize += 512; 

StringBuffer - (char *)realloc( 

StringBuffer, BufferSize); 
if(StringBuffer == NULL) 

return 0; /* FAILURE! */ 

) 

else 

return 0; /* FAILURE! */ 

} 

Length = LoadString(ResourceFile, Offset, 

LoadPoint, SpaceLeft); 

StringPointers[Offset] = LoadPoint; 

LoadPoint +* Length+1; 

) 

return 1; /* SUCCESS! */ 

) 

/* End of File */ 


What About Windows? 

Windows allows you to place strings in the resource file. 
Once there, anyone can use a third-party resource file editor 
to translate the strings (as well as the dialog boxes, menus, 
and so on) of your program to a foreign language. The prob¬ 
lem is, very few Windows programmers place their strings in a 
resource file. It is just too tedious to assign a unique identifier 
to each string, store it in a .RC file, and call LoadStringO at 
the correct spots to retrieve the string from the resource file. 
The version of the String Externalization Tools I reviewed was 
not designed for Windows. Nevertheless, I managed to adapt 
it for Windows use in a few hours. 
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BY TOM PLUM & DAN SAKS 


FIRST COMPREHENSIVE REFERENCE FOR PORTABLE 
AND MAINTAINABLE C++ PROJECTS 



Written for the professional C and C+ + 
programmer, C++ Programming 
Guidelines provides a comprehensive 
look at coding standards for C+ + . Ar¬ 
ranged in a “manual-page” format for easy 
reference, these guidelines can help a 
project reach agreement about matters of 
style and usage of C++. C+ + Program¬ 
ming Guidelines gives solid information to 
those programmers moving their C 
projects to C++. Issues of both lexical 
layout and more fundamental semantics 
support data and variables, operators, 
control statements, and functions. This 
book focuses on coping with version dif¬ 
ferences in nested types, templates, and 
exception handling. C++ Programming 
Guidelines explicitly details many of the 
restrictions typically imposed by success¬ 
ful C+ + programmers on their projects. In 
addition, tradeoffs associated with these 
restrictions and the reasoning behind them 
augment the discussion. 


PORTABILITY • READABILITY • CONSISTENCY 

C++ programming requires discipline to ensure that the program performs 
without “surprises” to the programmer or maintainer. C++ Programming 
Guidelines is useful to any C++ programmer who desires to write reliable 
C+ + programs which can be understood and maintained by other program¬ 
mers. Detailed explanations from Tom Plum, head of the C Compatibility 
Subgroup of X3J16 (C++) and Dan Saks, Secretary of the ANSI C+ + Com¬ 
mittee X3J16, make this book the most authoritative C++ reference. Tom 
Plum’s C Programming Guidelines is already widely accepted as the defacto 
standard for C programming style. Now, C++ Programming Guidelines 
brings the same kind of insight to C+ + style issues while including all of those 
C guildelines still relevant to C++. This book makes C+ + coding standards 
available to both veteran programmers and professionals who have an applica¬ 
tion expertise. 
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• Operators 

• Control Statements 

• Functions & Other Modules 

• Lexical Layout Rules 

• General Standards 

• Versions of C++ 
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First, I wrote the program in Listing 1, winext.c, to trans¬ 
late the string file into a .RC file. The string file has a very 
simple format the first line contains the number of strings in 
the file and each line after that contains a string. I only ran 
into a couple of glitches. The .RC file is also simple; each line 
contains an ID number followed by the literal string, bextstr 
numbers its strings starting from 2, so the program takes that 
into account Also, the resource compiler cannot handle the 
escape sequence “\” for some reason, so I wrote code to 
translate that into an octal equivalent. I wrote winext.c so 
that it generates a file [extent.h) containing macro definitions 
for the number of strings and the total number of bytes in 
these strings. I used this information in the routine that loads 
the strings into memory. 

Next, I wrote my own version of extstr.h (Listing 2) and 
extstr.c (Listing 3). extstr.h defines the macro EXT_STR() 
and NO_EXTERN()-, I modified each source file to include ex¬ 
tstr.h instead of ext.h. extstr.c defines LoadExternal- 
Strings(), the function that loads all the string resources into 
memory. After I wrote and debugged these listings, it took 
about five minutes to move all the strings in my 2,000-line 
Windows program into the resource file. 

Of course, you can still use the String Externalization Tools 
on Windows programs and produce the same kind of external 
string file as for DOS programs. However, if you want to follow 
the Windows programming guidelines and store the strings in 
a resource file, you will have to resort to a little bit of extra 
code, as I have done. Either way, having automated tools to 
extract the strings makes the job almost pleasant 

Foreign Language Pre-Processor 

This package of tools takes a slightly different approach to 
the problem of string externalization. If you want to avoid the 
overhead of dynamically loading in an external string file, this 
package is for you. The software consists of three programs 
and Figure 2 provides an overview of the three- step process. 

First, you use extract to extract all the strings from your C 
source into a string database, extract does not modify your 
source file. You can give the string database any eight-charac¬ 
ter name you want, extract creates both a database file and 
an index file. 

Second, you use display to translate your source strings 
into other languages. Unlike the other commands, display is 
a full-screen, character-mode program with menus and win¬ 
dows that even a novice can use. You use the display com¬ 
mand to create one or more foreign-language string 
databases. For each of these databases, you enter translations 
for each of the original source strings. 

Finally, you use flpp to create a localized version of your 
original source file. Note that this new source file still has 
string constants embedded in it, but they are the translated 
versions of the original strings. You would probably use a 
temporary directory to hold the source files for each different 
language. 

With the Foreign Language Pre-Processor, you produce a 
different executable for each language. You give up the 
flexibility of being able to select a different language at run¬ 
time, but you gain some efficiency. Also, because this ap¬ 
proach translates the string constants directly, you avoid the 


syntactic problems that bextstr has. Probably the main prob¬ 
lem flpp can introduce is when you try to initialize a fixed- 
size character array with a too-large translated version of the 
same string. Internationalization inevitably produces problems 
like this that require manual intervention. 

Upcoming Features 

As this article was being written, Network Dynamics 
released versions that support Pascal. The company also plans 
a set of new features for January release. The String Exter¬ 
nalization Tools will be able to append string files to your ex¬ 
ecutable, similar to the way the Windows resource compiler 
attaches resource data to . EXE files. The utilities will help you 
detect strings that have grown larger than the buffer space 
declared for them. Also, the company plans to help automate 
the task of deleting translated strings that become unused as 
you change and delete strings from one release to another. 

Summary 

There is nothing fancy about these two software packages. 
The documentation is sparse, the user interfaces are terse, 
and the installation software consists of the COPY command. 
When you face 100,000 lines of C code that needs inter¬ 
nationalizing, however, the important thing is to automate the 
tedious and error-prone job of locating and removing each 
string constant These packages handle that job efficiently and 
free your time up for the tasks that actually require a 
programmer's expertise. Having software to externalize strings 
removes one of the most objectionable obstacles to interna¬ 
tionalized software. □ 

Now, read over 50 records per 
second* * and share them with your 
friends, for just $69.95, and get the 
source code FREE! 



Multi-User Hashed File Manager 

For a limited time, the CDirect library of super-fast, 
multi-user, hashed-file functions for C, with locking 
support for LANs like Novell NetWare, LANtastic, 
Concurrent DOS, and PC-MOS is available at the 
unbeatable price of $69.95...and we’ll throw in the 
$249.00 source code, FREE! 

Now read and write variable-length records up to 
64K bytes long in a flash (up to twice as fast as 
trees) with any number of alternate keys, or use 
phonetic 'sounds-like" retrieval to find your 
records later. The complete documentation in¬ 
cludes file layouts, theory of operation, and a 
sample application. There are no royalties. 

So don’t miss this chance to have the CDirect 
library with source for only $69.95. ..because, one 
thing about CDirect, it always moves fast... 


Berg Engineering Company, Inc. 

1100 South Gilpin Street 

Denver, Colorado 80210 VISA 

(303) 698-2873 MasterCard 

* Test details available. CDirect is a trademark of Berg Engineering Company, Inc. 
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Learning to Program in C - 
2nd Edition 

By Thomas Plum 

In addition to giving the basics of 
pointers and structures, Plum guides 
the reader through portable programs 
for the full spectrum of processors, 
micro, mini and mainframe. The book 
is a tutorial, rather than a reference, 
and is designed to provide 
information you need to become a 
competent programmer in a real 
software engineering environment. 

Plum Hall, 372pp. ISBN:0-911537-08-2 

Y81. $29.95 
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C Programming 
Guidelines, 2nd Edition 

By Thomas Plum 

C Programming Guidelines offers a 
style standard for C projects, including 
rules and suggestions for consistent 
and portable use of C. Arranged in 
"manual page" format, it covers 
variables, data types, operators, 
expressions, statements, functions, 
files, libraries and documentation. An 
appendix covers some differences 
among many existing compilers. Plum 
Hall also offers a simple source license 
for the machine readable contents of 
the book. 


Plum Hall, 211 pp. ISBN:0-911537-07-4 

Y82. $29.95 
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Efficient C 

By Thomas Plum and Jim Brodie 

This book tells you how to make 
programs small and fast It includes 
tables of CPU time and code space for 
C operators, control structures, and 
function calls. It discusses optimization 
techniques performed automatically by 
several current compilers in various 
environments, as well as those 
techniques which can be effectively 
used by the programmer. It assists you 
in accurately estimating the resources 
your program will use without resorting 
to assembler listings. It also addresses 
techniques for translating other 
languages into efficient C. 

Plum Hall, 166 pp. ISBN:0-911537-05-8 

Y83. $29.95 


Reliable Data Structures in C 

By Thomas Plum 

Plum demonstrates how to use the 
"power" of C-pointers, structures, and 
files—with accuracy and knowledge. 
These techniques are illustrated with 
complete case study programs for 
sorting, screen handling, menu 
interaction, simulation, and record file 
handling. Besides discussing the 
formal aspects of each data structure, 
general purpose C functions are 
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Using WindowsMaker Professional 

Alex Leavens 


WindowsMaker Professional is a major upgrade of Blue Sky 
Software's earlier product, WindowsMaker, a development tool 
designed to help build Windows applications in C. The new 
version features a number of significant additions, including an 
integrated dialog editor and better control over user-created 
source code. 

WindowsMaker acts both as a graphical front end for build¬ 
ing an application's user interface and as a back-end code 
generator. From within WindowsMaker, you can dynamically 
build and alter all the pieces of your application; define or 
change objects such as windows and menu structures-, and 
attach functionality to the any object you've defined, including 
(but not limited to) menu entries, buttons, and icons. 

Once an application and the hooks to the pieces within it 
have been created, WindowsMaker generates the underlying 
C source code needed to build the application as a stand¬ 
alone executable, as well as the necessary make Files, link 
files, include files, and other support files. WindowsMaker will 


■ WindowsMaker Professional 

■ $995 (International version: $1245) 

■ Upgrade from WindowsMaker to WindowsMaker 
Professional: $240 

■ Supports Borland C++ 2.0, Microsoft C 5.1 or later, 
Zortech C++ 2.1 or later 

■ Comes with both 5-1/4" and 3-1/2" diskettes 
Blue Sky Software 

7486 La Jolla Boulevard, Suite 3 
La Jolla, CA 92037 
Telephone: (619) 459-6365 
FAX: (619) 459-6366 
Sales: (800) 677-4946 


also compile the application and let you run it directly from 
Windows. It strikes a good balance between protecting new¬ 
comers from much of the complexity involved in building a 
Windows application and giving seasoned veterans plenty of 
room to work. 

WindowsMaker does not replace the Windows SDK, but 
acts as an effective shield from it, organizing and mechanizing 
many repetitive tasks. The package also includes a suite of 
tools for such tasks as launching programs, moving and copy¬ 
ing source files, searching through source files for a particular 
string (essentially a form of grep for Windows), and many 
others (it is almost worth buying the package just to get the 
the “Flot launcher” application). 

l used WindowsMaker from the outset in developing 
ICE/Works Professional, expecting that I would outstrip its 
capabilities at some point. However, ICE/Works Professional 
has now grown from a small utility to a high-end application 
comprising 78 segments and more than 100,000 lines of C 
code, and I still use WindowsMaker - now WindowsMaker 
Professional - to develop and maintain it. 

Source Code Regeneration 

I found the original version of WindowsMaker a valuable 
tool for designing and building Windows applications, but was 
somewhat frustrated by one feature: the way in which 
WindowsMaker integrated the source code it generates with 
the application source code written by the programmer. 

The original WindowsMaker had three different kinds of 
source files: files that were completely under WindowsMaker 
control, files under joint WindowsMaker and programmer con¬ 
trol, and files completely under programmer control. If you 
changed an aspect of the user interface, Windowsmaker 
handled the three types of files quite differently. 


A/ex Leavens has more than 10 years of GUI design experience under numerous APIs, including both GEM and Windows. His 
most recent product is ICE/Works Professional, a high-end graphics resource editor for Windows. He can be reached at ShadowCat 
Technologies, Suite 741, 39120 Argonaut Way, Fremont, CA 94538, (510)796-2239. 
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Listing 1 

switch(wParam) 


/* ... */ 


case PROGRAMMER: 


ProgrammerRoutineO; 

/* Explicit call to prograirmer 

break; 

* defined code here serves to 

* override default code in the 

* .WMC file 
*/ 

/*...*/ 


default: 


BLDDefDialogProcO; 

/* Call default routine in .WMC 


* file here 
*/ 

break; 

} 



For files completely under Windows¬ 
Maker control, the change would cause 
the file to be regenerated; in the 
process any custom code included in 
these files would be erased. 

For files under joint WindowsMaker 
and programmer control, Windows¬ 
Maker would simply append any chan¬ 
ges to the end of the current file, leav¬ 
ing untouched any code that had al¬ 
ready been generated. Under these cir¬ 
cumstances it was safe to add custom 
code to a routine, since WindowsMaker 
would preserve that code when it 
regenerated the source file. 

For files completely under program¬ 
mer control, WindowsMaker simply 
kept a record in its database. Code in 
external modules was thus completely 
safe - you could change it dramatically 
and WindowsMaker would neither 
know nor care. 

This scheme worked well most of 
the time, but created problems when it 
was necessary to add code to one of 
the files that was under WindowsMaker 
control in order to achieve a certain 
result (overriding Window messages 
was a prime reason). On these oc¬ 
casions, I simply added the code to the 
module, and then tried to keep track of 
when WindowsMaker changed the code 
so that I could change it back. 

Another complicating factor was that 
WindowsMaker would sometimes 
detect that I had altered a file under its 
control and would inform me that it 
was changing the file-, at other times, 
however, it did not detect this and 
simply overwrote the file without warn¬ 
ing. 

Adding to my confusion was the fact 
that all three file types were . C source 
files. It was therefore impossible to tell, 


merely by examining the contents of a 
file, whether or not WindowsMaker 
considered the file its exclusive domain, 
subject to change without notice. 

WindowsMaker Professional removes 
the problem of differentiating files. With 
WindowsMaker Professional, I can work 
safely on all my . C source files. The 
new product preserves any code I add 
to any . C source file through all sub¬ 
sequent code regenerations. The only 
time code is removed from a . C source 
file is when I remove it. 

This increase in safety and ease of 
use did not come at the expense of 
flexibility. WindowsMaker Professional 
still uses the same three classes of files. 
The difference is in the nature of the 
files themselves. WindowsMaker Profes¬ 
sional now stores the code it exclusive¬ 
ly owns in a .UMC file, rather than a .C 
file. Then, other source files that need 
access to this code simply # include 
them. The code under joint control typi¬ 
cally calls the .UMC code in the default 
clause of a switch statement. This al¬ 
lows you to override the . UMC code by 
simply inserting your own code in the 
appropriate case of the switch state¬ 
ment. 

The key factor is the integration of 
source code files that belong exclusively 
to WindowsMaker Professional and 
source code files under joint control. 
Listing 1 shows a code fragment from a 
source code file under joint control. 
WindowsMaker Professional generates 
the source code for BLDDefDialog- 
Proc() and stores it in a .UMC file. As 
the fragment shows, you simply insert 
your own code above the default case 
of the switch statement to override the 


WindowsMaker function for any par¬ 
ticular command. 

The coupling of the . UMC file to the 
. C file lets the programmer specify how 
much of the default behavior is to be 
used. By choosing which messages to 
handle independently, you can override 
none, some, or all of the default be¬ 
havior in the .UMC file. You can also 
completely decouple the Windows¬ 
Maker Professional code from your own. 
There is a certain degree of danger in 
this level of flexibility, but it does pro¬ 
vide significant new capabilities. 

Among other benefits, the new 
scheme makes it much easier to add 
hooks for message types. Under the 
original WindowsMaker, you had to use 
the WindowsMaker interface to add a 
hook for a message type. With the new 
approach, you can either add the hook 
yourself, in the main message loop, or 
hook it in through WindowsMaker 
Professional. 

It’s even possible to use both 
methods of adding hooks, which is 
especially convenient when you want 
to test out a new function for a given 
message type, but don't want to 
destroy any currently working code for 
that type. As an example, you can have 
WindowsMaker Professional create code 
to handle the UM_MOUSEMOVE message. 
When you do so, WindowsMaker 
Professional will perform the following 
actions: 

• create a case statement in the mes¬ 
sage loop corresponding to 
UM_M0USEM0VE message, adding this 
code to the . UMC file. 

• add to this case statement a call to 
a user-defined routine. 

• create a routine with the user- 
defined name if one doesn’t already 
exist 

Then, when this code executes and the 
user moves the mouse, the following 
things happen: 

• The main message loop in the . C file 
retrieves the UM_M0USEM0VE message. 
Since it has no explicit case for the 
UM_MOUSEMOVE, it falls through to the 
default case, which calls B- 
LDDefaultMessageLoopO. 

• BLDDefaultMessageLoopO (in the 
.UMC file) switches.on the message 
number and branches to the case 
for UM MOUSEMOVE. 
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• This case contains code that calls the 

user-defined mouse move routine. 

For example, if you have a routine 
that currently handles the 
WM_MOUSEMOVE message, you use 
WindowsMaker Professional to hook the 
code into your program via the . UMC file 
of your main module. You can now also 
add the WM_MOUSEMOVE message to your 
own message loop in the .C file, effec¬ 
tively overriding the code you assigned 
with WindowsMaker Professional. The 
original working code is not called, 
while your new test code is. 

Once you have finished testing your 
new code, you can integrate it into the 
current code, and remove the 
WM_MOUSEMOVE message from your loop 
in the .C file. This feature has proved 
very useful to me on numerous oc¬ 
casions. 

Other New Features 

Another new feature of Windows¬ 
Maker Professional is an integrated 
dialog box editor capable of hooking 
any dialog item up to a variety of dif¬ 
ferent actions. A button can be hooked 
to an existing function, a (new) user 
defined function, another dialog box, a 
new menu bar, or an existing DOS pro¬ 
gram. This allows you to create not 
only the dialog box callback procedure, 
but all the callbacks for each of the ob¬ 
jects within the dialog box as well. 

This feature cuts dialog box develop¬ 
ment time significantly; using it, I 
created a complex dialog box, including 
menu interaction (the subsidiary dialog 
box has its own menu), graphic button 
callbacks, and more, in about two 
hours. When all the code structures 
were in place, I filled in the custom 
code to deal with each of the objects I 
had created. WindowsMaker Profes¬ 
sional had performed all the mechanical 
“cut and paste” work involved in creat¬ 
ing the dialog box. I had filled in the 
"essence” of the objects. 

Another useful feature of the dialog 
box editor is its ability to align objects 
with each other or within the dialog 
frame. Click on the object you want to 
align with, and then choose from a 
variety of alignment styles, such as left, 
centered, right (for horizontal aligment) 
or top, centered, and bottom (for verti¬ 
cal alignment). Click on other objects, 
and the editor aligns them with the 
selected object in the chosen style. 


Also handy is the ability to space 
objects evenly by defining the spacing 
you want as the spacing between the 
first and second objects you select This 
works well for groups of items such as 
radio buttons: you simply place the but¬ 
tons in the dialog box in the general 
area where you want them, space the 
first and second buttons properly, then 
set the spacing between all the other 
buttons equal to the space between 
the first two. The result is a set of even¬ 
ly and exactly spaced buttons. 

Another feature allows you to group 
a series of objects in a dialog box. 
Grouping a set of objects such as radio 
buttons allows you to use a single Win¬ 
dows API call (CheckRadioButtonO) to 
set and unset all the radio buttons at 
once, rather than having to set or unset 
each button by hand (using the Check- 
DlgButtonf) call). 

The grouping feature is not as 
thoroughly integrated into the dialog 
editor as the other features. It requires 
a series of complex steps for which the 
editor provides little feedback. In order 
to ensure that you have gotten the 
process right, you have to examine the 
source output of the dialog editor. 

The dialog editor also has the ability 
to import dialogs from other programs. 
This feature allows you to “snapshot” a 
particular dialog box from another pro¬ 
gram and edit and use it (being careful, 
of course, not to violate any copyrights). 
It also lets you see what kinds of ob¬ 
jects are used to construct particular 
kinds of dialogs. 

The feature that I used most fre¬ 
quently in the dialog editor was custom 
bitmap control, which allows you to 
create an area that has both an action 
and a bitmap linked to it. You can 
specify both the bitmap and the action 
directly in the dialog box, as well as im¬ 
porting the bitmap image into 
WindowsMaker Professional (if it is not 
already in there). 

This feature makes it easy to imple¬ 
ment owner-drawn control buttons. 
Since WindowsMaker Professional 
generates all the code for both receiv¬ 
ing the WM_OWNERDRAW message and 
drawing the bitmap itself, all I had to do 
was determine the state of the button 
(using the flags from the DRAW IT EM 
structure) and decide whether to draw 
the image “down" or “up" (each image 
corresponding to a separate bitmap). By 
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using my own icon editor (which I have 
integrated with WindowsMaker Profes¬ 
sional), I was able to create great-look¬ 
ing bitmap buttons in about as much 
time as it would have taken me to 
produce simple text-based ones. For 
anyone who wants to create custom 
buttons containing graphic images, this 
is a very powerful feature. 

Another new feature is the ability to 
give the object in the dialog editor a 
user-defined ID, which is especially nice 
for giving related objects similar names. 
However, once you assign a user ID in 
WindowsMaker Professional, the 
product never forgets that name, even 
if you disconnect the name from every 
object you have created. You can cre¬ 
ate user IDs, it seems, but you cannot 
delete them. 

Other new features of Windows¬ 
Maker Professional make it easy to cre¬ 
ate and manipulate menus and menu 
entries. Every object supports direct 
manipulation, which means that you 
can double click on any menu entry 
and bring up the possible actions for 
that menu entry, including renaming 
the entry and hooking or changing its 
functionality. 

Animation Test Mode 

A new mode, called Animation Test 
Mode, causes WindowsMaker Profes¬ 
sional to simulate your application. The 
product simulates all the functions you 
assigned with WindowsMaker Profes¬ 
sional: if you assigned a dialog box to a 
particular menu entry, then clicking on 
that menu entry in Animation Test 
Mode will bring up the dialog box. 

The dialog box is also “live” in 
Animation Test Mode, performing any 
actions you hooked to controls within 
the dialog. In fact, you can use 
WindowsMaker Professional and Anima¬ 
tion Test Mode to build a fully function¬ 
al application without having to 
generate source code or compile any¬ 
thing. 

The Animation Test Mode, however, 
works only for code that Windows¬ 
Maker Professional knows about. If you 
have a custom routine that does some¬ 
thing special, it is not executed, but 
merely noted. WindowsMaker Profes¬ 
sional will optionally display the name 
of any routine that would be executed 
as a result of an action. 


Probably the most useful feature of 
Animation Test Mode is that all the ob¬ 
jects are still pliable. Double click on 
any object in Test mode, and you can 
immediately start editing the object 
and its behavior. This is useful for test¬ 
ing out the “feel” of a given section of 
your program. You can keep working 
with it until it feels right. 

This facility is probably the most im¬ 
portant reason for using a tool like 
WindowsMaker Professional rather than 
doing it by hand. So much work is in¬ 
volved in creating a user interface by 
hand that simply getting the thing run¬ 
ning is a major achievement - and one 
that most people don’t want to go back 
to even if there is room for improve¬ 
ment. WindowsMaker Professional 
changes that: it enables you to con¬ 
tinue to tinker with the interface while 
you are developing your program. 

Summary 

WindowsMaker Professional makes it 
easy to change and rearrange most 
aspects of an application’s user inter¬ 
face. For a DOS programmer just starting 
out in Windows, this high degree of 
flexibility may be somewhat daunting 
and may raise questions about why it’s 
necessary to keep adapting the user in¬ 
terface. The answer is that the user in¬ 
terface needs to change to reflect the 
changing understanding of the design 
problem. 

Until recently, good user interface 
design for Windows programs has been 
hampered by development tools that 
discouraged experimentation. Tools that 
were difficult and time-consuming to 
use virtually guaranteed an abbreviated 
design process, resulting in a product 
with an attenuated user interface. 

WindowsMaker Professional allowed 
me to design and develop a commer¬ 
cially viable product in half the time it 
took me to create a similar product, 
containing fewer features, on a different 
platform. Building a good Windows 
product is difficult, not least because of 
a lack of good GUI design tools. 
WindowsMaker Professional, however, 
will go a long way towards easing your 
development headaches. □ 
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New Products 

Industry-Related News & Announcements 


Inmark Enters Windows Class Library Fray 

Inmark Development Corporation has released zApp, a 
C++ class library designed to simplify Windows development 
by encapsulating the Windows 3.0 API within C++ classes. Al¬ 
though written in C++, developers can integrate zApp into ex¬ 
isting Windows C applications. zApp provides memory 
management that is faster than the Windows API functions 
and avoids exhausting the pool of global memory handles. 
zApp simplifies accessing the printer from Windows by auto¬ 
mating support for banding, status dialogs, and other print¬ 
ing tasks. It also contains built-in support for selecting and 
configuring printers. 

One problem that C++ Windows class libraries face is 
mapping Windows messages onto C++ class member func¬ 


tions. zApp implements a hierarchical dynamic message han¬ 
dling facility that can dynamically dispatch messages, or ran¬ 
ges of messages, to individual C++ member functions. zApp 
allows the user to create dialog boxes either at runtime or 
from dialog resources. zApp also includes a high-level forms 
package with field input validation. 

The package includes tutorials, a programmer's guide, a 
reference manual, and a collection of sample programs. zApp 
costs SI95 (or $295 with source) and requires Borland C++ (ver¬ 
sion 2.0 or newer) or Zortech C++ (version 2.18 or newer). For 
more information, contact Inmark Development Corporation, 
2065 Landings Drive, Mountain View, CA 94043, (415) 691- 
9000; FAX (415) 619-9099; BBS (415) 691-9990. 


Heap Expander v3.0 Offers Uniform Virtual Memory 


The Tool Makers has updated Fleap Expander, a real 
mode alternative to DOS extenders for C programmers. Heap 
Expander allows programmers to access memory outside of 
the normal 640Kb of real mode memory, providing access to 
up to 240Mb of heap space. 

This version of Heap Expander features a new library 
that allows the programmer to access expanded memory, 
extended memory, conventional memory, and hard disk 
space in any combination, as a huge virtual memory pool. 
The Heap Expander now supports XMS and VCPI standards 


for extended memory, and the LIM v4.0 specification for ex¬ 
panded memory. 

This new version is backwardly compatible with pre¬ 
vious versions and supports all current versions of Microsoft 
C, Turbo C, Turbo C++, Borland C++, and most standard C com¬ 
pilers. Heap Expander v3.0 costs $119.95 and comes with full 
source code and documentation. For more information, con¬ 
tact The Tool Makers, P.O. Box 2151, Santa Cruz, CA 
95063, (408) 458-0690; FAX (408) 458-1011. 


Blaise Computing Introduces and Enhances Tools 


Blaise Computing Inc has introduced a new library and 
upgraded several of their other products for C and C++ 
programmers. Windows Control Palette is a DLL that 
provides a variety of custom controls, tool bars, and dialog 
boxes. Windows Control Palette is compatible with C, C++, 
Turbo Pascal, Visual Basic and Actor. The package costs $149 
and includes source code and a reference manual that 
describes how to create and modify custom controls. 

Blaise has released version 2.1 of Win++, a class library 
for Borland C++ Windows applications. This version adds 
more than 30 classes and now supports the dynamic data 
exchange management library, including clients, servers, ad¬ 
vise loops, and multiple simultaneous conversations. Win++ 
costs $249 and includes complete source code, a manual, 
and sample programs. 

Blaise's Turbo Vision Development Toolkit is a set of 
utilities and an object class library designed especially for 
use with Turbo Vision. The toolkit includes a resource editor 


for interactively creating or changing dialog boxes and other 
resources, a utility to convert Turbo Vision resources into 
Windows resource script files, and object and class libraries 
that extend Turbo Vision's capabilities. The Turbo Vision 
Development Toolkit costs $149 and includes a reference 
manual, tutorial, and source code for all objects and utilities. 

The C ASYNCH MANAGER is a library that provides exten¬ 
sive serial port support for applications written in Borland 
C++, Turbo C++, Turbo C, Microsoft C, and QuickC. The library 
supports XMODEM, YMODEM, and ZMODEM file transfer 
protocols and allows background and multiple simultaneous 
transfers. The library supports interrupt levels above 7, the 
16550A FIFO queues, and multiport boards such as the 
Digiboard PC/X. C ASYNCH MANAGER costs $189 and includes 
a manual and complete source code. 

For more information on any of these products, contact 
Blaise Computing, Inc., 819 Bancroft Way, Berkeley, CA 
94710, (415) 540-5441; FAX (415) 540-1938. 
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MEM_WING Provides Windows Global Memory Management 


Montana Software has released MEM_WING, a memory 
manager for Windows 3.0 global memory. The library replaces 
the standard C functions caHoc(), free(),malloc(),real- 
loc(), and strdupf) with memory management functions 
that suballocate far memory from blocks of Wndows global 
memory. Allocating global memory in blocks helps avoid the 
Wndows system limitation of 8192 global memory handles. 


Compile-time definitions allow you to compile a debug¬ 
ging version of the library and to control both the memory 
block size and the total number of blocks the library can allo¬ 
cate. The library supports Microsoft C and Borland C++. 
MEM_WING costs $59.00 and includes complete source code. 
For more information, contact Montana Software, P.O. Box 
663, Bozeman, MT 59771-0663, (406) 586-2984. 


MTASK Combines Multitasking And Instrumentation 


MTASK Professional 3.2 is a DOS multitasking and serial 
port manager designed for scientific laboratories and in¬ 
dustrial automation companies. Instrument monitoring and 
automatic measurement control often require real-time in¬ 
teractions with external devices via the serial ports. MTASK 
addresses this need with a combination of multitasking and 
serial I/O support Developers can use MTASK to construct 
programs that simultaneously monitor multiple external 
equipment or mix equipment monitoring with data acquisition. 

MTASK runs in about 45Kb and supports both text and 
graphics modes. The system provides fast task switching and 
the total number of tasks is limited only by available 
memory. MTASK facilitates task communication with wait 


state interrupts, semaphores, and critical sections manage¬ 
ment MTASK supports both XON/XOFF and hardware flow 
control. The package supports both the standard PC serial 
ports and four-channel, UNIX-compatible serial cards. 

Language support currently includes Turbo Pascal, Turbo 
C, Turbo Basic, Quick Pascal, Basic, and Quick C The package 
includes a 350 page manual. MTASK Professional 3.2 is avail¬ 
able in English as well as French, and in a number of dif¬ 
ferent configurations and prices. For more information, 
contact RAMS/ International, 218 avjean Jaures, F-92140 
CLAMART, France, 33 (1) 46.31.60.75; FAX 33 (1) 
46.32.48.37; Minitel 33 (1) 46.30.24.23. 


General Software Adds Toolkits 


General Software has released two new toolkits to aug¬ 
ment their line of operating system products. The new 
toolkits include C and assembly source code so developers can 
adapt them for their own use or in commercial applications. 

Device Driver Toolkit contains source code to model 
drivers for the standard DOS devices: CON, AUX, PRN, NUL, 
CLOCK$, and disk devices. Users can study the example 
drivers, cut and paste code, and build new drivers to support 
additional features or hardware. The disk driver supports the 
"Generic I0CTL' interface and provides support for raw track 


I/O, formatting, and verification. The code also handles 
primary, extended, and huge (>32Mb) partitions. 

DOS Utility Toolkit contains full C source code to General 
Software's version of COMMAND. COM, A TTRIB, CHKDSK, DIS- 
KCOMP, DISKCOPY, DISKVIEU, FDISK, FIND, FORMAT, LABEL, MODE, 
MORE, SORT, SYS, and TREE. Users can build on these programs 
to construct customized DOS utility sets, or study how the 
existing utilities work. For more information, contact General 
Software, P.O. Box 2571, Redmond, WA 98073, (206) 391- 
4785; FAX (206) 746-4655. 


Bootcon Offers Easier Configuration 

Modular Software Systems has released version 1.60 of 
Bootcon, a utility that lets users select from among 26 dif¬ 
ferent system configurations during the boot process. Users 
who need to work with different configurations of hardware 
and software often have to juggle multiple sets of CON¬ 
FIG.SYS and AUTOEXEC.BAT files. Bootcon automates this 
management, allowing the user to select from a menu of 
configurations at boot time. 

Silverware Introduces EMM Library 

Silverware has released the *C EMM Library, a collection 
of more than 60 functions that provide a C interface to the 
Expanded Memory Manager (EMM) device driver. These 
routines provide both a high-level and a low-level interface 
to the LIM EMS v4.0 memory specification. The package sup¬ 
ports all memory models and works with Microsoft C, 
Microsoft Quick C, and Borland Turbo C The package includes 


Bootcon vl.60 now supports DOS 5.0, includes more cus¬ 
tomization options, a syntax checker, and an auto-boot 
utility. Bootcon uses 256Kb of memory while running, but 
only 450 bytes after the boot completes. Bootcon 1.60 costs 
$59.95 and comes with a 30-day, unconditional, money-back 
guarantee. For more information, contact Modular Software 
Systems, 115 W. California Blvd., Suite #113, Pasadena, CA 
91105, (818) 440-9104; FAX (818) 440-9240. 


commented source code so you can customize it for in¬ 
dividual applications. 

The Silverware "C” EMM library costs $199 and comes 
with Norton Guides Database on-line help and an uncondi¬ 
tional, money-back guarantee. For more information, contact 

Silverware, Inc., 3010 LBJ Freeway, Suite 740, Dallas, TX 
75234, (214) 247-0131; FAX (214) 406-9999. 


Cross Referencer Crosses Language Boundaries 


FileXref is a cross-referencing tool that operates on all the 
files in a software project source code, MAKE files, batch files, 
and ASCII documentation. Given a list of file names, FileXref 
scans them, producing cross-reference information that shows 
filenames and the files that reference them. You can optionally 
specify a list of symbols and symbol patterns for inclusion or 
exclusion. You can specify which of several report formats File¬ 
Xref should use, or produce a format suitable for importing 
into a database. 


The package supports BASIC, batch files, C, C++, COBOL, 
FORTRAN, MAKE Files, MASM, Oracle, Pascal, PL/I, REXX, SQL, 
XBASE, and any ASCII text files. This version supports em¬ 
bedded SQL and contains a facility for excluding symbols 
from the cross reference. FileXref vl.3 costs $25 plus ship¬ 
ping and handling ($2 inside the United States, $10 outside). 
For more information, contact ConVal Software, Inc., 11607 
E Butter Creek Rd., Moorpark, CA 93021, (805) 529-6847. 
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Xian Releases TPW Prototyping Tool 

Xian Corporation is now shipping Winpro/3TPW, a 
resource manager, code generator, and application 
prototyper for Borland's Turbo Pascal for Windows (TPW). 

The product helps create and manage an application's 
resources (dialog boxes, menus, icons, cursors, and so on). 
After using Winpro/3TPW to interactively design your 
application’s user interface, you can have the product 
generate, compile, and link the code to implement that inter¬ 
face. Winpro/3TPW produces commented, object-oriented 
Pascal code and even produces documentation for the code 
it generates. 

After generating the user interface code with 
Winpro/3TPW, you can modify and extend that code to build 
your application. Winpro/3TPW’s update system preserves 


Program Teaches Windows Programming 

WindowsTeach is an interactive system that teaches 
Windows programming through graphic tutorials, hypertext, 
and stepwise code annotations and explanations. The pro¬ 
gram presents key Windows concepts graphically and sup¬ 
plies source code explanations along with hypertext 
clarifications within a multi-windowed environment 

WindowsTeach has three components: the Concepts 
Track, the Programs Track, and the Hints and Suggestions 
section. The Concepts Track graphically explains the struc- 


changes you make in the generated code, a key feature for 
prototyping systems. The product works with both Borland’s 
Resource Workshop and the Whitewater Resource Toolkit 
The code that Winpro/3TPW generates supports the Borland 
Windows Custom Controls in dialog boxes. 

The package requires Microsoft Windows 3.x and Borland 
Turbo Pascal for Windows. Winpro/3TPW costs $249.95 and 
includes a user guide that explains, step-by-step, how to cre¬ 
ate a simple Windows application. The user guide reference 
section has enough information to allow you to customize 
how the product generates code. For more information, con¬ 
tact Xian Corporation, 62 5 N. Monroe St, Ridgewood, NJ 
07450, (201) 447-3270; FAX (201) 447-2547. 


ture of Windows. The Programs Track has 21 programs, each 
illustrating a feature of Windows, showing the top level first 
and allowing the user to zoom into more details and then 
get to the source code with hypertext The Hints and Sugges¬ 
tions section provides tips to save programming time. 

WindowsTeach requires Windows 3.x and costs $123. For 
more information, contact IntelligenceWare, 5933 W. Cen¬ 
tury Blvd., Los Angeles, CA 90045, (213) 216-6177; FAX 
(213)417-8897. 


Quantasm Expands Assembly Language Library 


Quantasm Corp is now shipping Quantasm Power Lib 
v2.0. This new version is over twice as large as the previous 
version and contains over 600 assembly language routines 
coded for speed and compactness. The library is designed 
for assembly language programmers and can be called from 
C, BASIC, Pascal, and FORTRAN. 

Quantasm Power Lib contains a forms package, menu 
and windowing systems, over 100 string handling functions, 
extended precision math functions, a complete set of 


date/time functions, filename and command-line parsing, 
sound control, data compression, and more. The library sup¬ 
ports any size text screen, a mouse, DOS extenders, memory 
managers, TSRs, and high-level languages. 

Quantasm Power Lib v2.0 costs $99.95, or $299.95 with 
source code. For more information, contact Quantasm Cor¬ 
poration, 19855 Stevens Creek Blvd., Cupertino, CA 95014, 
(408) 244-6826. 


Paladin Upgrades DataScope 


Paladin Software, Inc., has released version 2.0 of their 
DataScope, a protocol analysis and data capture tool for PC 
users. This program can collect as much as 8Mb of data and 
signal information with microsecond timestamp resolution. 
Paladin has enhanced DataScope with tiled concurrent win¬ 
dow displays and a pull-down menu interface. 

You can have up to four unique and simultaneous dis¬ 
plays active at the same time, providing passive, interactive, 
and historic monitoring in any selected combination. You 
can combine display tiles to create larger windows and one 
of the four presentation filters (Mixed, Alternating, COM1, or 


COM2) can be applied to every window. The program offers 
full archive parameter control combined with pre-, center-, 
and post-trigger positioning. 

DataScope can operate at all UART baud rates up to 
115.2Kbaud while matching user-specified trigger strings 
against incoming data. DataScope Version 2.0 costs $229 and 
requires DOS v2.1 or newer, 256Kb of memory, and at least 
one serial port The package includes connector shells, 
cables, and a manual. For more information, contact Paladin 
Software, Inc, 3945 Kenosha Ave., San Diego, CA 92117, 
(619) 490-0368. 


dANALYST GOLD Adds NetWare SQL Support 


Buzzwords Intemationl, Inc., has added Novell NetWare 
SQL to its dANALYST GOLD Windows development system. 
This will allow dANALYST GOLD users to develop applications 
that take advantage of Novell’s relational database engine. 
dANALYST GOLD can generate both Windows and DOS char¬ 
acter-mode applications. dANALYST GOLD with NetWare SQL 
allows you to partition your data across multiple servers and 
supports relational joins across multiple NetWare SQL ser¬ 
vers; the physical location of the data is transparent to the 
application program. 


dANALYST GOLD supports both C and C++, the XBASE rela¬ 
tional database languages, Paradox with SQL, and NetWare 
SQL The package includes the SoftC shareware library, which 
helps merge dBASE data files to Novell’s Btrieve and SQL For 
more information, contact Buzzwords International, Inc., 
2879 Hopper Rood, Cape Girardeau, MO 63701, (314) 334- 
6317. 
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PR0F-1T Offers Real-time Profiling 

Incredible Technologies, Inc., has released PROF-IT, a non- 
invasive statistical code profiler to analyze software perfor¬ 
mance. PROF-IT monitors program execution by sampling 
processor addresses and checking them against symbol 
table data. It then displays the percentage of time the pro¬ 
gram spends in each routine. Programmers an use this infor¬ 
mation to focus their optimization efforts on the most 
profitable areas of the code. PROF-rT works in real time, 
providing an analysis as the program being profiled is running. 

PROF-IT requires no hardware or code modifiations. It is 
compatible with many software development systems in¬ 


cluding Uniware, Sierra, and Axtec/Manx. PROF-IT supports 
many processors in several package types and an even con¬ 
nect to program ROMs for unusual or custom processors. 
PROF-IT works through a serial interface to an AT or 
equivalent with at least 360Kb of memory. 

The base configuration of PROF-IT costs $295; configura¬ 
tions are available for 6502,68xx, 68000, Z80, and 808x 
processors. For more information, contact Incredible Tech¬ 
nologies, Inc, 709 W. Algonquin Road, Arlington Heights, 

IL 60005, (708) 437-2433; FAX (708) 437-2473. 


DAS Offers Cheap Data Acquisition 

EASY DATA is a new hardware and software package to 
provide low cost data acquisition for the PC The package in¬ 
cludes a hardware device that plugs directly into the PC 
parallel port The unit an acquire up to 16 signals simul¬ 
taneously with a nominal single input throughput of 4KHz. 
Input polarity is software selectable for unipolar or bipolar 
operations with a measurable voltage range of -10 to 10 


volts. Software selectable gains are in steps of 1,10,100, or 

1 , 000 . 

The unit also has a single analog output apable of 
producing pulsed, square, ramp, or triangular waves. EASY 
DATA costs $269 and includes the graphics-oriented 
software and a 30-day money back guarantee. For more in¬ 
formation, contact DAS, Inc., 1034 Industrial Road, Orem, 
UT 84057, (801) 224-8080; FAX (801) 224-8087. 


Sealevel Systems Introduces Interface Card 


Sealevel Systems, Inc, has released an industrial inter¬ 
face ard for the PC The enhanced DIO-32B relay/sensor I/O 
board provides 16 read relay outputs and 16 optially iso¬ 
lated inputs. This is an improved version of the company's 
DIO-32. The board uses reed relays for quality, long lifetime 
switching of low voltage, low current signals, or to provide 
closed contact switching signals. The optially isolated input 
ports an monitor voltages or signals that require ground 
isolation. 

The board occupies four I/O port loations and you an 
use multiple boards in a single system. User options include 


selectable I/O address and interrupt request line. The pack¬ 
age includes example appliation software to demonstrate 
how to turn the relays on and off and how to read the input 
sensors. 

The board is available from stock as part number 3093 
and costs $339. For more information, contact Sealevel Sys¬ 
tems, Inc, 102 W. Main Street, P.O. Box 830, Liberty, SC 
29657, (803) 843-4343; FAX (803) 843-3067. 


Abraxas Introduces Portability Tool 

Abraxas Software, Inc., has released a 32-bit OS/2 version 
of CodeCheck/2, an expert system that validates C and C++ 
source code for portability to DOS 5.0, Windows 3.0, OS/2 1.0, 
and other 16-bit environments. CodeCheck/2 works with 
WorkFrame/2, IBM's programmer workbench facility. The 
product determines if C and C++ products developed on OS/2 
2.0 are portable to other platforms. Programmers an use 
this feedback to develop more portable source code. 


CodeCheck/2 now reads all variants of C and C++ source 
code, including Microsoft, Borland, and Zortech. CodeCheck/2 
for DOS costs $495. The OS/2 version costs $695 and AIX 
licenses are $995 per seat Source code licenses are also 
available for minicomputer and mainframe sites. For more in¬ 
formation, contact Abraxas Software, Inc, 7033 S.W. 
Macadam Ave., Portland, OR 97219, (503) 244-5253; FAX 
(503) 244-8375. 


CodeTranslator Aids dBASE To C Conversion 


Sequiter Software Inc has released CodeTranslator vl.0. 
The new translator combines the high-level CodeBase 4.2 
library routines with low-level C code to create efficient 
stand-alone appliations. The CodeTranslator accesses all pro¬ 
cedure and data files, resolves the types and scopes of vari¬ 
ables and generates the entire C appliation. This allows 
developers to create in dBASE and then translate to C The 


result runs faster in less memory than the original dBASE ap 
pliation, but retains its look, feel, and file compatibility. 

CodeTranslator costs $195 and is royalty-free. For more 
information, contact Sequiter Software Inc., #209,9644-54 
Avenue, Edmonton, Alberta, Canda, T6E 5V1, (403) 437- 
2410; FAX (403) 436-2999. 
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Readers' Forum 


We ask that letters with code listings be 
submitted in an ASCII text file on an MS- 
DOS formatted disk. Providing us an 
electronic copy of the code will prevent 
typographical errors that might result 
from optical scanning or re-keyboarding. 


Dear Mr. Burk, 

When I received my November 1991 
issue of TECH Specialist, the first article 
to catch my eye was advertised on the 
cover as “A Super-Fast strlenf)" (page 
55). Intrigued, I read the six-page text of 
the article which provided a comparison 
between the standard way to code a 
strlenf) function, and a fast method 
implemented using a LODSU string in¬ 
struction. The analysis of the relative 
speeds of the two algorithms was fairly 
comprehensive and the article provided 
some useful optimization techniques, 
but the new algorithm is fundamentally 
flawed. Referring to the code fragment 
as published in Listing 3, page 56: 

; DS:SI points to start of string 

REPEAT: 

LODSW 

TEST AH, AL 
JNZ REPEAT 

; Assuiption here: Either AL or AH is OOh 


The intention of the above code is to 
load two bytes from the string at one 
time, placing the first byte in AL, and 
the second byte in AH. If either AH or AL 
is zero, the TEST instruction will set the 
ZERO flag, and the branch to REPEAT will 
not be taken. This signifies the end of 
the string. However, the algorithm does 
not account for the fact that the TEST 
instruction does a BITUISE-AND be¬ 
tween AH and AL, not a LOGICAL-AND. 
Thus, the ZERO flag could be set even if 
neither AH nor AL were zero. For ex¬ 
ample, consider the following string: 

“A STRING OF 25 CHARACTERS" 


The first character, A, has ASCII code 
41 h, or binary (01000001). The second 
character, the space, has ASCII code 20h, 
or binary (00100000). Taking the BIT- 
UISE-AND of these two bytes gives: 

01000001 = 'A 1 
AND 00100000 = ' 1 


00000000 

As you can see, the BITUISE-AND of 
these two characters yields zero, and so 
the algorithm would terminate, thinking 
it had found a zero byte. For the ex¬ 
ample string, the LODSU algorithm as 
written returns a length of 1, which is 
incorrect. Despite this flaw, the algo¬ 
rithm is interesting. It could be cor¬ 
rected by comparing both AH and AL 
explicitly with zero after falling past the 
JNZ REPEAT instruction, and jumping 
back into the loop if either is non-zero. 
For certain strings, this may still be 
faster than the standard strlenf) 
method. 

Michael R. Henry 
1801 Village Square Court 
Severn, MD 21144 
Thanks to the following, who also 
wrote to point out the code problem 
here - Jim Boemler (Mukilteo WA), 
James Waldby (Robinson IL), Dan 
Bruth (Los Angeles CA), John Sprung 
(Universal City CA), and Jeffrey Harper 
(Charlotte NC). -rib 


Dear Ron: 

In regards to the letter to the editor 
from Stanley Brown about my program 
TYPEAHED.SYS, I would like to point out 
that the potential problem he mentions 
was partially taken care of in the instal¬ 
lation section of the Dummy Device 
Driver. If you will look at the code care¬ 
fully, you will see that I place the new 
buffer only on a 256 Byte boundary. 
This is accomplished with the ADD 
AX, 000FFH and AND AX.0FF00H instruc¬ 
tions. This placement takes care of the 


“Byte Stuffers” putting fixed byte values 
into variable word pointer locations. 
This includes Microsoft’s ANSI. SYS driver 
released with DOS 2 through DOS 4. DOS 
5 does not have the problem, so I now 
use a TYPEAHED.SYS without the “Byte 
Stuffer” fix. 

This leaves, as he also pointed out, 
those “Word Stuffers" who put fixed 
word values into variable word loca¬ 
tions. When this program was dis¬ 
tributed by PC World magazine, Tom 
Swan, who edited the “*.*" column told 
me it wouldn't work with Aston-Tate's 
MultiMate. l would assume it doesn’t 
work with other programs as well, 
especially the keyboard enhancement 
programs. What strikes me as funny is 
that a simple MOV AX,HEAD and MOV 
TAIL,AX set of instructions works cor¬ 
rectly to empty the buffer even though 
it is not “programmatically correct” 

There is no way you can correct for 
everyone’s poor programming, but, by 
pointing it out, you can prevent some 
of it in the future. That is why I use 
published ROM-BIOS listings to deter¬ 
mine how things are defined and used. 
When I first saw the ROM-BIOS listing 
and the first two pointers (HEAD and 
TAIL) I looked into the code to see how 
they were used. When I also found that 
the code used the second pointers 
(START and END) I knew that the buffer 
was relocatable and expandable. My 
first effort was working well until I did a 
DIR\M0RE command. That’s when 
ANSI.SYS struck (the clear keyboard 
buffer command was a “Byte Stuffer”). 

A TSR could use a lot of the PSP area 
if the programmer was careful to 
preserve those areas to be used later. 
Again, full documentation on the con¬ 
tents of the PSP is required. 

There is no problem in releasing the 
environment from within a TSR when it 
has been spawned by any shell includ¬ 
ing another copy of C0MMAND_C0M. The 
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allocation of the environment is done 
by DOS, not the shell, and the terminate 
and stay resident deallocation is also 
done by DOS and not the shell, so all is 
OK. When a regular program terminates, 
DOS determines the user ID (the seg¬ 
ment address of the PSP) and then does 
a walk down the memory control 
blocks to release all blocks that have 
the same user ID, thus releasing the en¬ 
vironment and any other blocks the 
program had acquired as well as the 
program itself. The DOS function to ob¬ 
tain the user ID has now been identified 
in the DOS 5 documentation. 

I now have a 4Mb computer so I 
don’t worry so much about memory 
usage and that old 512Kb computer 
now sits unused. That old computer 
sure taught me a lot. Windows 3.0 and 
OOP programming is a different ball 
game. 

Sincerely yours, 

Clifford Van der Yacht 
2363 Lourdes Dr. West 
Jacksonville, FL 32210-3410 

Some years ago, I wrote my own 
little shell that was a small-model C 


program. I’m pretty sure that I allo¬ 
cated the environment string out of the 
local heap and poked a far pointer to 
that into the PSP before doing the 
EXEC of each command. I was not 
aware that DOS replaced this pointer 
with a pointer to a copy of the environ¬ 
ment I created. I guess I'll have to dig 
that old code up and try it just to 
prove it to myself. Thanks for the his¬ 
tory on TYPEAHED.SYS and congratula¬ 
tions on the new computer, -rib 


Dear TECH Specialist, 

I am responding to a question sub¬ 
mitted by Jim Davis in the January 1991 
issue. His question is in regard to the 
(unshifted) 5 key on the number pad. 
Personally I’ve found that the operation 
of this key varies from machine to 
machine, depending on its BIOS and 
exact keyboard. A program I wrote as 
part of the GEM UTILITIES (misspelled as 
GEN UTILITIES in January’s issue), 
KEYTEST, uses BIOS interrupt 16h. Func¬ 
tion 0 is used to check the keyboard 
status and function 1 to read the key. 

On this machine (a DTK XT) the 5 
key is reported as an extended charac¬ 


ter, which means it takes two (ASCII) 
characters to identify it. KEYTEST reports 
that it has the value of OOh, 4Ch. The 
4Ch is the scan code. 

Good Luck, 

George McLam 
P.O. BOX 417124 
Sacremento, CA 95841 
Thanks for the answer. Sorry about 
the misspelling; we scan letters 
electronically to save time, but some¬ 
times the process introduces errors, 
—rib 


Dear Mr. Burk: 

I was reviewing some back issues of 
TECH Specialist tonight, and noticed 
several “Letters to the Editor" that said, 
“I almost cancelled my subscription to 
TECH Specialist, but...”. This is just to say 
that I have no intention of cancelling 
my subscription to TECH Specialist, your 
magazine is excellent and meets my 
needs. Please keep doing what you are 
doing. I primarily am interested in ar¬ 
ticles on C and assembly, particularly in 
MS-DOS, so your current mix of lan¬ 
guages is just fine with me. I would not 


Figures 1 through 4 for Robert Bybee’s “Writing For The PC Speaker," vol. 2, no. 12. 
The figures illustrate the “Digital vs. Analog Waveforms” discussion. 
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Developer's 

Marketplace 


EGAD 

Screen Print Package 

• Supports VGA, EGA, CGA, 
MGA displays up to 800x600 

• Select printout colors/gray 
tones; print any rectangular 
region; enlarge graphics 1-4 
times; many other features 

• Works with most printers 

• TSR (Shift-PrtSc) or call from 
your program. TSR is 9-15K. 

• Licensing available. 

$35.00 postpaid. Free catalog. 


LS Software 8139 E. Mawson, 
Mesa, AZ 85207 (602) 380-9175 

□ Request 124 on Reader Service Card □ 


TUB ™ is FASTEST! 



RCS™ 4.2 PVCS™ TUB™ 3.0 TUB™ 5.0 


Times are to update a 45K library on a PC/XT. PVCS and TUB 3.0 are 
from Sept 87 PC Tech Journal. MKS RCS 4.2 and TUB 5.0 are newer. 

TUB™ is BEST! 

“Do not be fooled by the fact that this is the 
least expensive of the five packages reviewed 
here - TUB has features and power to spare" 
John Rex, Computer Language 
“TUB is a great system” J. Vallino, PC Tech J 

• Full-Featured Version Control for Software 
Professionals. Check-in/out locking. Branching. 
Keywords. Wildcard and list-of-file support. Can 
merge parallel changes and undo intermediate 
revisions. Network and WORM support. Main¬ 
frame compatible deltas for Pansophic, ADR, IBM, 
etc.. Integrates with Opus™ MAKE & Slick™ MAKE. 

MS-DOS $139, OS/2 $195 shipping Visa/MC 
5 station LAN license $419 (OS/2 $595), call for other sizes 

BURTON SYSTEMS SOFTWARE 

PO Box 4156, Cary, NC 27519 (919)233-8128 

□ Request 137 on Reader Service Card □ 
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PostScript Power 

PSPlot Post Script' printer mana¬ 
ger. Converts HP-GL plots to Post ¬ 
Script' or EPS; plots lines any width or 
color. Has Post Script editor, font 
downloader and error display. Prints 
ASCII/FORTRAN files. Puts PC and 
MAC fonts in RAM or on printer disk. 
Works on networks. $175 

Double 11 ’ Booklet maker. Ideal for 
instruction manuals, reports. Accepts 
Post Script output files from Ventura, 
Sprint, PageMaker, WordStar, Interleaf, 
Manuscript, Word for Windows, etc. 

Save paper with duplex printing, even 
from non-duplex printers. $259 

Legend Communications, Inc. 

54 Rosedale Avenue West 
Brampton, ON, Canada L6X 1K1 

30 day guarantee 

(800)668-7077 (416)450-1010 

□ Request 191 on Reader Service Card □ 




PostScript TSRs — Under 9K 

PSFX TSR prints Post Scrip t out¬ 
put, just as formatted for Epson or IBM 
ProPrinter. See graphics, fonts, accents 
and boxes! Choose portrait or landscape, 
sizes up to 11 xl7. Print one or two 
pages per sheet. Use with databases, 
accounting, PrtSc key. $85 

PSFXnet Novell NetWare version 
adds banner pages. Keeps statistics on 
pages printed by each userlD. $99 

EPScreen Captures PC screens as 
tiny Encapsulated PostScrip t (EPS) 
files (3K), frames & TIFF optional. 
Illustrations for manuals. Font included. 
Color files less than 10 K. $95 

Legend Communications, Inc. 

54 Rosedale Avenue West 

Brampton, ON, Canada L6X 1K1 

30 day guarantee 

(800)668-7077 (416)450-1010 



□ Request 157 on Reader Service Card □ 


Arctos 

SYSTEMS CORPORATION 

X-Port Parallel Adapter 

Expand mass store capabilities 

Attach CD-ROM and SCSI based 
peripherals to a single parallel port 

Comes with drivers for DOS, MSDEX 

Low power, compact size 

For notebooks, laptops, desktops 

$225 + shipping & handling 

PO, Cheque, VISA 

300 March Rd., 4th Floor, 

Kanata, Ontario, Canada, K2K 2E2 
(613) 591-3084 (613) 591-1806 (fax) 
Dealer & OEM enquiries welcomed 


□ Request 101 on Reader Service Card □ 



"Highly recommended" - J. Dvorak, PC Magazine 
"Outstanding... lets you explore the creative 


possibilities of fractals" - Amstrad PC Magazine 
"Quick and easy to master" - New Scientist 
"Impeccably lucid... operations are fast " - BYTE 

Fractal programming tutorial, 160-page Guidebook, 
Microsoft C programs, 200 + modifiable templates. 
Supports DXF and PCX files, CGA to Super-VGA. 

Orders/Info: CALL 802-888-5275 

Cedar Software box si4o-ri, womsviiie vr osssi 
□ Request 171 on Reader Service Card □ 


The Loose Data Binder vl.6 is a 
persistent container class with a 
stack-queue-deque-list-array 
interface and built-in sort-search- 
iterate functions. Being persistent, 
a LDB can be saved on a stream 
and later reloaded while multiple 
references are automatically 
resolved. Streamable class 
packages / wraps your data for 
streaming. Includes C++ 2.X 
source & 130+ page manual, $60. 

The Austin Code Works 
11100 Lcafwood Lane 
Austin, Texas 78750-3587 USA 
Voice: (512) 258-0785 
FAX: (512)258-1342 
Mastercard / VISA 

□ Request 173 on Reader Service Card □ 


Opt-Tech Sort'Merge 


Extremely fast Sort / Merge / 
Select utility. Run as an MS- 
DOS command or CALL as a 
subroutine. 

Supports most languages and 
filetypes including Btrieve and 
dBase. Unlimited filesizes, mul¬ 
tiple keys and much more! 


MS-DOS $149. 
OS/2, UNIX $249. 


Opt-Tech Data Processing 

P O Box 678 
Zephyr Cove NV 89448 

(702) 588-3737 



□ Request 127 on Reader Service Card □ 
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mind seeing some C articles written 
with a bend toward the Macintosh 
operating system, which I am trying to 
learn. However, I realize I might not get 
my wish. 

I was looking through my back is¬ 
sues tonight because 1 thought 1 
remembered reading part of an article 
that gave some tricks for determining 
what machine type. 1 know how to 
determine DOS version, but how do I 
tell if I’m running on a PC-XT, AT, ’386, 
or other type of machine? Could you 
point me in the direction of that article, 
or maybe give me some hints on that 
subject? 

Also, if I may make a suggestion, I 
would love to communicate with TECH 
Specialist and TECH Specialist readers via 


computer bulletin board (BBS) - I’d even 
be willing to pay for the privilege. It 
would give me a chance to meet other 
TECH Specialist readers and talk to 
them. I’ll bet other TECH Specialist 
readers would be interested, too. Have 
you given any thought to operating a 
bulletin board for readers? 

Vic Walker 
811 Shasta Circle 
El Dorado Hills, CA 95630-4535 


On behalf of the team that creates 
the magazine, thanks! I trust we will 
continue to meet your needs under 
our new moniker. You're right, we 
won't be covering the Mac until we 


have about 200 editorial pages per 
issue, and that may take a while. For 
one algorithm for determining the 
processor type, see page 50 of the Oc¬ 
tober 1991 issue. I think the idea of an 
electronic forum for readers is a good 
one, but I don't know if there's enough 
interest to justify a special-purpose BBS. 
That’s a good question to ask in the 
editorial survey, though, —rib 


A corrected listing for Stephen Nebel's 
“A Fast Get-Length-of-ASCIIZ," vol. 2, no. 
11 appears on page 47. 



Developer's 

Marketplace 


The Upper Deck Editor 

A Serious Editor For Windows 3.0 

Edits files larger than 64K, real 
UNDO (300 levels), regular expres¬ 
sions, search across multiple files, 
split-screen file comparison, com¬ 
piler support, keyboard macros, fully 
customizable. 

INTRODUCTORY PRICE $75 

Call for our fully functional 

DEMO DISK! 

(619) 741-1075 

Upper Deck Systems 

P.O. Box 2751, Escondido, CA 92033 
□ Request 350 on Reader Service Card □ 


UNIVERSAL 

Cross-Disassembler 


Missing source? Debugging? 
Upgrading an unsupported 
product? Then XDASM may be 
the solution. This unique MS- 
DOS based software disassembles 
programs for several types of 
microprocessors and 
microcontrollers. Creates an 
“Assembler Ready” source file 
from a Hex or Binary input file. Has configurable 
output to match assembler. Allows full control of 
disassembly using a separate TAG file. Assigns label 
names, provides instruction line detail, inserts 
assembler directives, deblocks source code into 
subroutines and generates multiple cross-reference lists. 
Processor families include: 1802, 4004, 6301, 65C02, 
6800, 6805, 6809, 68HC11, 7810, 8048, 8051, 8085, 

8096, COP400/800, Z8, Z80, Z180 plus others. Dual 
media diskettes and manual, $249. CROSS-16, the 
universal Meta-Assembler, available for $99. 

Check/ MO, PO COD. 

Data Sync Engineering 

P.O. Box 146 

East Stroudsburg, PA 18301 

Tel (717) 421 -1977 Fax (717) 421 -9095 

□ Request 161 on Reader Service Card □ 




Notice to Windows/DOS Subscribers 

Occasionally, Windows/DOS makes its 
mailing list available to vendors of 
products we think our readers will find in¬ 
teresting. Current subscribers receive free 
information in the mail from these ven¬ 
dors. If you prefer that your name not be 
used in these mailings, please let us 
know. Just copy or clip this form and send 
it with your name and address to: 



Q DEVELOPER'S JOURNAL 

1601 W. 23rd. St, Ste. 200 
P.O. Box 3127 
Lawrence, KS 66046-0127 
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CopyControl 
COPY PROTECTION 


Control your profits with the copy protection designed 
with strength, user-transparency and compatibility. 

• Beats ALL the bit-copiers & Dis-assemblers 

• No hardware plugs or special disks required 

• Encrypts your program & adds anti-debug code 

• Allows you to produce full function demos 

• Compatible with LAN, backups & disk utilities 

• Supports all Floppy & Hard disk formats 

• Allows you to change parameters remotely. 
Control when, where, and how your software is ran. 
Compatible with all IBM/DOS Computers. 

$595 Unlimited Version, 30 day Money back guarantee 
[■b Also available by Meter Count fast 
MbI Free Demo & Info • COD • P0 


Drawer 0, Wellington, MO 64097 * 

(800) 237-8400 ext. 212 
(816) 934-8384 / Fax (816) 934-2617 

□ Request 162 on Reader Service Card □ 



Speed Up Development With: 
Programmer’s SUPER-MAINT* 

SUPER-MAINT builds your make and 
response files, remembers your command 
flags, the make file name, and more! 
SUPER-MAINT works for you so you can 
focus where you need to: on your 
programming! Still only $55 (+ zso lAh. NY 

reaideati add ulei tax). 


'/ can’t tdlyou bow nitty this thing it .* Joseph Stan, Ufri Data 


Make File Builder Supports Microsoft, Borland, Aztec, 
Clipper, Mix languages: just "point and shoot" at code 
files you want in your program, multiple setups, user 
configurable. Free CompuServe Intro Pak with 
purchase. 



EmmaSoft 


PO Box 238 
Lansing, NY 14882 

Voice: (607) 533-4685 
BBS: (607) 533-7072 


BS EE] 


□ Request 352 on Reader Service Card □ 
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Win Goat 

The JORF® Language is the Easy 
OOP language that supports same 
source, same data, same key¬ 
strokes, same menus and mouse 
for fancy DOS and fast Windows. 

• Program for DOS PCs and Windows 

• Translates to create true EXE files 

• Named after a Goat 

Shareware Interpreter 
and Tutorial $10 

Registration, Manual 
Debugger, Editor ...$85 

C Translator for 
Borland* C++.$85 


The |ORF Company 
25858 Elwood Road 
Colton, OR 97017 
(503) 824-JORF 


□ Request 285 on Reader Service Card □ 



BGI PRINTER DRIVERS 


Hardcopy drivers for the Borland BGI 
graphics interface with full source! 

The BGI Printer Driver Toolkit provides BGI 
printer drivers for Epson 9 & 24 pin dot matrix, 
HP LaserJet II, and HP PaintJet printers. Use 
the BGI graphics interface to effortlessly 
generate high resolution hardcopy with Turbo 
C, C++, and Turbo Pascal. Full driver source 
provided for your tutorial pleasure. $89.95 . 


PC TIMER TOOLS 


Over 60 functions implement microsecond 
resolution timing, precision delays, extensive 
interrupt profiling, and full timer tick interrupt 
management. Supports TC, TC+ + , TP, and 
MSC. Full library source included. $49.95 


Prices postpaid USA, elsewhere add $4.00. 
VISA and MasterCard accepted. 


RYLE 

DESIGN 


PO Box 22 

Mt. Pleasant, Ml 48804 
517-773-0587 


□ Request 280 on Reader Service Card □ 


FLOATING POINT 
ARRAY PROCESSOR 

+ Operates on Arrays & Matrices; 
Integer. Real, & Complex Structures. 

* Process math-intensive algorithms 
100 times faster than the 80387. 

* 598 mathematic & scientific functions 
on-board in EPROM, callable from C. 

* Private high speed STATIC memory 
(0.25 to 4.25 megabytes) on board. 

* 3 megabytes/sec to/from ISA host. 

+ Direct hardware link to video & A/Ds. 

* 1000 page reference manual. 

+ $2495.00 complete with software. 

* Call for function list and benchmarks. 

Eighteen Eight Laboratories 

1-800-888-1119 FAX 702-294-2611 
1247 Tamarisk Lane 
Boulder City, NV 89005 

□ Request 150 on Reader Service Card □ 


Instant Microcontroller 

+ 

Instant C 


Instant New Product 

Use our Little Giant™ and Tiny Giant™ miniature 
microprocessor-based computers to instantly com¬ 
puterize your product. Our miniature controllers 
feature built-in power supplies, digital I/O, serial I/O 
(RS232 / RS485), A/D converters (to 20 bits), 
solenoid drivers, time of day clock, battery backed 
memory, watchdog, field wiring connectors, and 
more! Designed to be easily integrated with your 
hardware and software. Priced from $159. Core 
modules as low as $59. Low cost, interactive Dy¬ 
namic C™ makes serious software development 
easy. 

Z-World Engineering 

1724 Picasso Ave., Davis, CA 95616 USA 

Tel: (916) 753-3722 Fax: (916) 753-5141 

Automatic Fax: (916)753-0618 
(Call from your fax. request catalog #18) 


□ Request 279 on Reader Service Card □ 



DEVELOPERS! 

AEQEAOnEPL! 

GOING INTERNATIONAL? 

Our string extemalization utilities and C 
functions can help you get your package ready 
for the international market. 

These proven utilities extract literal strings 
from your C source code, ready for editing, 
translation or encryption, without impacting 
your original executable. While saving scarce 
initialized data space, these functions allow 
your easily re-denned prompts to behave as if 
they were compiled directly into your program. 
This permits the original executable to "speak" 
the language of your choice, even Japanese! 

Includes all object/source code and libraries 
for popular C compilers. Price $149.95 for ob¬ 
ject, $249.95 for source code site license. No 
royalties. DOS, Unix, Mac, etc. VA residents 
add sales tax. 

Network Dynamics, Inc. 

2225 S. Henry Street, Suite L-2 
Williamsburg, VA 23185 
Phone (804) 220-8771 Fax (804) 220-5741 

□ Request 149 on Reader Service Card □ 

January 1992 


'C' and C++ - DOCUMENTATION TOOLS 


! AUTOMATED DOCUMENTATION ! 

• C-CALL ($59) Creates a graphic-tree of 
the caller/called functions, and creates 
a files-vs-functions table of contents. 

• C-CMT ($59) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($49) new! Calculates the path 
'cyclomatic' complexity of functions, counts 

lines of Comments, Code, 'C* statements. 

• C-LIST ($49) Lists and action-diagrams, 
or reformats source into standard formats. 

• C-REF ($49) Creates cross-reference of 
local/global/define/parameter identifiers. 

- SPECIAL OFFER ($189) All 5 programs, 
fully integrated as C-DOC DOS program, 
plus free OS/2 protected-mode program. 

• 30-DAY Money-back guarantee CALL NOW 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 
^^anadc^^^M^J^6^85fM466 

□ Request 135 on Reader Service Card □ 


SDLC, HDLC 
And X.25 Support 

Use Sangoma hardware and software 
to provide fast, cost effective, robust 
and easy to use SDLC, HDLC and X.25 
links from MS-DOS, UNIX, Concurrent 
DOS etc. 

All real time communication functions 
are performed by intelligent coproces¬ 
sor card. Line speeds up to 160 kbps 
are supported. Powerful debugging, 
line statistics and trace facilities are 
included. 

Full function SNA emulation packages 
also available. 

Sangoma Technologies Inc. 

n (416) 474-1990 


32-bit Protected Mode 
386 C Graphics Library 

Intel 386/486 C Code Builder 
MetaWare, MicroWay, SVS, 
Watcom & Zortech with 
Phar Lap 3861 ASM 

Mixed Raster/Vector, 
Scalable, Rotatable Font, 
VGA, SVGA, 8514/A, VESA, 
Hercules Graphics Station 
through 1024x768x256 (8-bit), 
640x480x32k (16-bit), 
512x480x16.7m (32-bit), 
WYSIWYG HP-GL/PostScript 
$200 NO ROYALTIES 
FULL SOURCE CODE 
Gary R. Olhoeft 
P.O. Box 10870 Edgemont 
Golden, CO 80401-0620 
303-877-3697 CIS 76665,2021 

□ Request 294 on Reader Service Card □ 


NETWORK 

CONTROL 

LIBRARIES 

NETBIOS ROUTINES allows ac¬ 
cess to low-level network func¬ 
tions. Name, session, and 
datagram routines. Wait and no¬ 
wait options. $99 

NETBIOS DLL for Windows $199 

NETWORK MASTER provides 
access to Netware internal func¬ 
tions. Complete network control 
from your compiled programs! $99 

Starlight Software 

P.O. Box 1090 
Wheeling, IL 60090 

(708) 394-0622 _ 

□ Request 170 on Reader Service Card □ 
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MS dos System 
Programming 


2nd Edition 


Edited by Robert Ward 
A/OIV-You can get the informa¬ 
tion most programmers don’t 
even know about. 

PLUS -Gain access to a critical 
bibliography that will become an 
indispensible resource to y ou. 

HIGHLY TECHNICAL 
HIGHLY FOCUSED 


A 

MS-dos 

system programming 


Every entry is written by 
working programmers for 
working programmers. In¬ 
cluded are compiler- 
specific insights that will 
save you hours of work. 
Find out how to exploit spe¬ 
cial Turbo C features to 
simplify device drivers. Plus 
a bibliography designed to 
help the serious program¬ 
mer develop a personal 
library of MS-dos literature. 


edited by 

ROBERT WARD 


Nitty Gritty Coverage on 
These How-to Topics 


e Critical Error Handling 
e Customizing the DOS 
Boot Strap 
o Interrupt-Driven I/O 
o Manipulating 

Environmental Variables 
o Event Timing 
o Writing TSRs 
o Controlling the Disk 


Hardware 
Writing Device K 
Drivers - T - 

Released July 1991, 240 pp. ISBN 0-923667-20-2' s \ <£0/195 

mRECTLY Windows/PO SlS 2 *" 

FROM □ DEVELOPER'S JOURNAL 


913 - 841-1631 

FAX: 913-841-2624 



Is your 
spec 


product 

al? 


Is it so special only a 
programmer can 
understand it? 

Then advertise in 

Windows’/DOS 

□ DEVELOPER'S JOURNAL 

Call (913) 841-1631 today 

to reserve space 
for your ad. 

Ask for Edwin (Western Region), 
Donna (Midwestern Region), 
or Ed (Eastern Region). 
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FREE 

Product 

Information 

Use this postage paid 
card to stay up to date 
on products 
that affect 
your productivity. 

Just fill out the card at 
the right and 
drop it in the mail. 



□ DEVELOPER'S JOURNAL 

Please help us serve you by 
answering the following: 

1) I program: 

□ for a living 

□ as a hobby 

□ as a manager 

2) I program in: 

□ MS-DOS 

□ Macintosh 

□ Xenix/UNIX 


1601 W. 23rd. St.. Ste. 200 
P.O. Box 3127 
Lawrence, KS 66046-9943 
(913) 841-1631 FAX: (913) 841-2624 

REQUEST READER SERVICE NUMBERS: 



NAME 


3) I program most frequently in: 

□ Assembly 

□ Pascal 

□ BASIC 

□ C 

□ Other _ 

□ Please send me subscription information. 


COMPANY 

ADDRESS 


CITY/STATE/ZIP 

PHONE 


3.1 



NO POSTAGE 
NECESSARY 
IF MAILED 
IN THE 

UNITED STATES 


BUSINESS REPLY MAIL 

FIRST CLASS MAIL PERMIT NO. 682 LAWRENCE, KS 
Postage will be paid by addressee 

Windows/POS 
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P.O. Box 3127 
Lawrence, KS 66046-9943 
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KJ DEVELOPER'S JOURNAL 

□ YES! Send me 12 issues of Windows/DOS Developer’s Journal for only $29! 

□ 2 years (24 issues) for $54 □ 3 years (36 issues) for $77 

□ Bill Me □ Visa □ MasterCard 


Number_ Exp. 

Signature_ 
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CouniyiProvince/Maiicod^^ 

Please allow up to six weeks for delivery of first issue. Orders outside the US must be prepaid in US funds. CANADA/MEXICO 
subscriptions are: 1 year - $38; 2 years - $63; 3 years - $86. Overseas subscriptions are: 1 year - $48; 2 years - $88; 3 years - $126. 
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COMPUTER 

LANGUAGE 



BAT 


INSTALL &0 GIVES YOUR SOFTWARE PRODUCT 
A PROFESSIONAL INTRODUCTION. 


Installation procedures that rely on 
batch files and DOS commands not 
only look amateurish but also have 
limited error handling capabilities. 
Today's users expect quality and ease 
of use from software — beginning the 
moment they open the package. A 
smooth, professional installation 
makes an important first impression. 

EVERYTHING YOU NEED 

INSTALL 3.0 is customized for your 
product with an ASCII text file called 
a "script file." INSTALL 3.0 comes 
with many sample script files that you 
can modify and use immediately. No 
programming is necessary to create 
most installations. However, C source 
code is included for your convenience 
and technical support is free. 

FAST AND SIMPLE 

Use INSTALL 3.0 to create an elegant 
installation procedure that will 
increase users' confidence in your 
product. INSTALL 3.0 takes advan¬ 
tage of available RAM for lightning- 
fast file transfers. All your documen¬ 
tation has to tell users is TYPE 
"A: INSTALL". 


INSTALL PRO 

• Builds distribution disk sets 
automatically 

• Creates a configuration file, 
containing all parameters for 
each disk set 

• Automatically builds INSTALL 
script files 

• Automatically formats disks 
(360K, 720K, 1.2M, 1.44M) 

• Uses a full screen, point-and- 
shoot interface for fast, efficient 
file tagging 

• Automatically splits large files 
across multiple diskettes 

• Literally cuts distribution disk 
building time from days to 
minutes for complex products 


Knowledge Dynamics 
Corporation 

Highway Contract 4, Box 185-H 
Canyon Lake, Texas (USA) 
78133-3508 

□ Request 103 on Reader Service Card □ 


PROVEN RELIABILITY 

INSTALL 3.0 has been used for over 
four years by some of the biggest (and 
smallest!) names in the industry, in 
the U.S. and abroad, to install millions 
of copies of their programs. Add your 
name to the list today. 

30 DAY MONEY-BACK 
GUARANTEE 

Free technical support. No royalties. 
MasterCard/VISA/COD/POs 
welcome. 

$399.95 INSTALL PRO 
$249.95 INSTALL 3.0 
$99.95 International Option 
$99.95 OS/2 Option 

SALES 

1/800-331-2783 ext. #0194 

International 
1/512-964-3994 
24 hour FAX 1/512-964-3958 
24 hour BBS 1/512-964-3929 

CALL OR FAX BY NOON 
AND RECEIVE INSTALL 3.0 
TOMORROW! 







Get Inside WINDOWS! 



Debug Windows at the systems level! 


Soft-ICE/W takes you inside Windows! Debug and explore with 
power and flexibility not found in any other Windows debugger! 
Soft-ICE/W allows you to debug at the systems or applications 
level or simply learn the inner workings of Windows. 




CodeView for 
Windows users 


• Debug VxD's, drivers and interrupt routines at source level 

• Debug interactions between DOS T&SR’s and Windows Apps 

• Debug programs in DOS boxes 

• Display valuable system information 

(from the total memory occupied by a Windows application, to the 
complex internal structures of Windows) 

Soft-ICE/W uses the 386/486 architecture to provide break point 
capabilities that normally require external hardware. Nu-Mega, 
which pioneered this technology with the introduction of its 
award winning Soft/ICE for DOS, now gives Windows program¬ 
mers the same debugging power... and still at a software price. 

Own the debugger that combines the best "view" of Windows 
internals with the most powerful break points of any software 
debugger. 


See what you're debugging 
without flash 

CV/1 version 2.0 runs CodeView in a 
graphics window letting you see 
CodeView and the program screen 
at the same time, If you're spending 
more than 10 minutes a day in your 
debugger you should be using CV/1. 

• Runs CodeView on any monitor that 
supports Windows. 

• No more "Flip-Swap-Flash". 

Step through code without the 
annoying flash. 

• Small Window Mode shrinks the 
debugging window to a few lines 
of source, 


Soft-ICE/W. . . Only $ 386 


CV/1 v2.0 . . . $ 129 


con ( 603 ) 889-2386 
fax ( 603 ) 889-1135 


N 

u- 

M 

tea 

RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 

P.O. Box 7780 

Nashua, NH 03060-7780 U.S.A. 

^TECHNOLOGIES INC 



MICROSOFT WINDOWS IS A REGISTERED TRADEMARK OF MICROSOFT CORP. Soft-ICE/W AND CV/1 ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES, INC. 
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